Galpi
폐쇄망에 설치하기
인터넷 없이 갈피 서버와 노드를 설치하고 올려요. 오프라인 번들과 사내 미러, 두 길이 있어요.
| 길 | 언제 | 갈피에 넣는 것 |
|---|---|---|
| 오프라인 번들 | 인터넷이 아예 없는 곳 | OFFLINE=1, 갈피 판마다 번들 하나 |
| 사내 미러 | Nexus·Artifactory·Harbor 같은 미러가 있는 곳 | MIRRORS=from=to … |
둘을 같이 써도 돼요. 노드는 무엇이든 이 순서로 찾아요: 그 노드에 이미 받아 둔 것 → 갈피 서버의 오프라인 번들 → 사내 미러 → 인터넷(OFFLINE=1이면 가지 않아요). 어디서 받든 고정한 SHA-256과 맞춰 봐요.
폐쇄망 모드(OFFLINE=1)
OFFLINE=1이면 갈피는 사이트 밖에 연결하지 않아요. 밖이 있어야 하는 기능은 꺼지고 "폐쇄망이라 꺼져 있어요"가 붙어요. 막힌 연결은 시간 초과를 기다리지 않고 바로 실패해요(EGALPIOFFLINE).
- 서버가 시작하자마자 프로세스 전체에 문지기를 걸어요. 갈피가 아는 인터넷 서비스(ipapi.co, Fly Sprites, OpenAI, Anthropic, GitHub, npm 등)는 이름만 보고 DNS도 묻지 않고 막아요.
- 그 밖의 이름은 사이트의 DNS에 물어서 공인 주소가 하나라도 나오면 막아요. 루프백과 사설 주소는 그대로 가요.
- 화면에서 바깥 주소(LLM, S3, OIDC 등)를 저장하려 하면 그 자리에서 이유와 함께 거절해요.
- 모델은 사내 모델 서버(OpenAI 호환 또는 Anthropic 호환 게이트웨이)를 써요. 인증서는 수동 인증서와 사내 DNS를 써요.
오프라인 번들
인터넷이 되는 리눅스(x86_64, Docker) 머신에서 갈피가 쓰는 모든 것을 받아 .tar 하나로 만들어요. 갈피의 판마다 하나예요.
node-kit/offline/build-bundle.sh --out /tmp/galpi-offline
# --runtime e2b|sysbox|both 실을 노드 런타임
# --vscode <커밋> 코드 편집기의 VS Code 서버와 CLI도 실어요
deploy/build.sh # 갈피 이미지
docker compose --profile git build forgejo-backup # Forgejo 백업 이미지
deploy/offline-images.sh # 갈피·Caddy·Forgejo·versitygw·rclone 이미지
docker load -i galpi-images-<id>.tar
docker volume create galpi_galpi-data
tar -xf galpi-offline-<id>.tar -C "$(docker volume inspect -f '{{.Mountpoint}}' galpi_galpi-data)"
# deploy/.env에 OFFLINE=1, VM_CALLBACK_URL=node, 수동 인증서와 사내 CA를 준비한 뒤
docker compose up -d --no-build --pull never
Docker가 없는 서버는 번들 안의 apt 저장소로 Docker를 설치해요. 노드는 시스템 관리 → 노드의 가입 명령으로 붙이고, 노드가 갈피 서버의 번들에서 소프트웨어를 받아요.
사내 미러
MIRRORS는 from=to 쌍이에요(공백·쉼표·줄바꿈으로 나눠요). from으로 시작하는 주소를 to로 바꿔 받아요. 노드 설치, VM 안의 패키지 설치(npm, PyPI, Go, Docker)가 이 규칙을 따라요.
MIRRORS="https://registry.npmjs.org/=https://nexus.corp/repository/npm/ https://pypi.org/simple/=https://nexus.corp/repository/pypi/simple/"
프로젝트 패키지 캐시
VM에서 npm ci나 pip install이 인터넷 없이 되도록, 온라인 머신에서 프로젝트의 의존성을 받아 반입하는 스크립트가 있어요(deploy/project-dependencies.py). npm은 package-lock.json, Go는 go.mod와 go.sum이 있어야 해요.
확인한 것과 아직인 것, 노드와 VM의 사내 CA, 갈피를 올릴 때의 순서는 갈피 저장소의 docs/폐쇄망.md에 있어요.
인터넷 없이 · 오프라인 · 망분리 · 사내망 · 인터넷 차단