OpenCode 서버

OpenChamber는 OpenCode 서버 위에서 실행됩니다. 기본적으로 OpenChamber가 서버를 직접 시작하므로 따로 할 일은 없습니다. 이미 운영 중인 서버를 OpenChamber가 사용하도록 지정하거나, OpenChamber가 시작한 서버를 관리하려는 경우에만 이 페이지가 필요합니다.

OpenChamber가 서버를 찾는 방법

OpenChamber가 시작되면 다음 순서로 서버를 찾습니다.

이미 시작한 서버를 재사용합니다
외부 서버를 사용하도록 지정했다면 그 서버에 연결합니다(아래 참고)
기본 포트(4096)에서 서버를 자동으로 감지합니다
그 외에는 자체 서버를 시작하고 관리합니다

아무것도 설정하지 않으면 4단계가 자동으로 실행되어 바로 사용할 수 있습니다.

이미 운영 중인 서버에 연결하기

OpenChamber를 시작하기 전에 다음을 설정하세요.

OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber

OPENCODE_HOST — 포트를 포함한 OpenCode 서버의 전체 주소(예: http://localhost:4096)입니다. 끝에 경로가 붙어서는 안 됩니다.
OPENCODE_SKIP_START=true — OpenChamber가 자체 서버를 시작하지 않도록 지정합니다.

포트만 변경하면 된다면 OPENCODE_HOST 대신 OPENCODE_PORT를 설정하세요.

OPENCODE_HOST에 포트가 없거나 경로가 붙어 있으면 OpenChamber는 이를 무시하고 자체 서버를 시작하는 방식으로 되돌아갑니다. 예상한 연결이 일어나지 않았다면 시작 로그에서 [config] 경고를 확인하세요.

CLI에서 서버 관리하기

openchamber status
openchamber logs
openchamber restart
openchamber stop

openchamber만 입력하면 서버가 백그라운드에서 시작됩니다. 터미널에 연결된 상태로 유지하려면 --foreground를 추가하세요.

로그인할 때 OpenChamber 시작하기

startup enable을 사용해 네이티브 사용자 서비스를 설치하세요. OpenChamber는 macOS에서 launchd, Linux에서 systemd --user, Windows에서 Task Scheduler를 사용합니다.

openchamber startup enable
openchamber startup status
openchamber startup disable

UI를 보호하려면 서비스를 활성화할 때 비밀번호를 설정하세요:

OPENCHAMBER_UI_PASSWORD='secret' openchamber startup enable

startup enable은 현재 환경의 스냅샷을 서비스에 저장해, 같은 셸에서 openchamber를 직접 실행한 것에 더 가깝게 동작하게 합니다. provider 토큰, PATH, SSH agent 설정, 기타 CLI auth/config 환경 변수가 유지됩니다. 최소한의 서비스 환경을 원하면 --no-env-snapshot을 사용하세요.

실행 중인 이 서비스의 터널은 별도로 관리할 수 있습니다:

openchamber tunnel start --port 3000
openchamber tunnel stop --port 3000

터널을 중지해도 서비스나 앱은 재시작되지 않습니다.

”OpenCode is restarting”