Docker로 타워 설치하기
Docker는 서버 프로그램과 DB를 함께 실행하는 도구입니다. 이 안내는 Linux PC에서 설치를 진행하는 IT 담당자를 위한 문서입니다.
Windows EXE로 시작하는 분은 Windows 실행 안내를 읽어 주세요.
이 PC에는 여러 직원의 점검 정보가 모입니다. 실제 직원 PC를 연결하기 전에 서버 관리 안내를 읽고, 서버 PC와 관리자 계정의 보호를 준비해 주세요.
1. 필요한 프로그램 확인
Git, Python 3, OpenSSL, Docker Engine, Docker Compose v2가 필요합니다. 터미널에서 아래 명령이 동작하는지 확인하세요.
git --version
python3 --version
openssl version
docker --version
docker compose version
Docker를 사용할 수 있는 일반 사용자 계정으로 작업합니다. 서버 데이터와 백업을 저장할 디스크는 회사의 디스크 암호화 방법으로 보호하세요.
2. 소스 받기
git clone https://git.tla.so/erickim/techlabs-discovery.git
cd techlabs-discovery
3. 우리 회사 서버 주소로 설정하기
아래의 192.168.1.50은 예시 주소입니다. 직원 PC가 접속할 실제 서버 IP나 사내 DNS 이름으로 바꿔 주세요.
python3 tools/configure.py --host 192.168.1.50 --bind 0.0.0.0
docker compose up -d --build
docker compose ps
첫 실행에서는 필요한 구성 요소를 내려받고 빌드합니다. 인터넷 연결이 필요하며 완료까지 시간이 걸릴 수 있습니다.
설정 도구는 설치마다 다른 비밀번호, 암호화 키와 인증서를 만듭니다. 이미 설정한 폴더에서는 다시 생성하지 않습니다.
실행 상태에서 db, api, web이 정상으로 표시되면 다음 단계로 갑니다. 사내 방화벽은 필요한 직원 PC의 8443번 HTTPS 연결만 허용하세요. DB 포트를 따로 공개할 필요는 없습니다.
4. 인증서를 등록하고 첫 관리자 만들기
- IT 담당자가 설치 폴더의
.local/tls/ca.crt를 확인합니다. - 확인한 인증서를 관리자 PC의 신뢰할 수 있는 인증서로 등록합니다.
- 브라우저에서 앞서 설정한 서버 주소를 엽니다. 예시 주소는
https://192.168.1.50:8443입니다. - 최초 관리자 생성 화면에
.env파일의TOWER_ADMIN_KEY값을 입력합니다. - 첫 관리자 아이디를
admin으로 만듭니다.
admin은 기본 PIN 발급자입니다. 다른 아이디를 사용하려면 시작 전에 .env의 TOWER_PIN_ISSUERS도 해당 아이디로 지정해 주세요.
TOWER_ADMIN_KEY는 서버 관리자용 키입니다. 직원에게 전달하지 않습니다. 인증서를 신뢰하지 않는다는 오류가 나오면 IT 담당자에게 확인해 주세요. 오류를 무시한 채 운영하지 않습니다.
5. 직원 PC 연결하기
에이전트 안내에 따라 공개 릴리즈 파일을 dist/agent에 배치하고, 타워의 에이전트 등록에서 등록 키를 만듭니다. 공개 설치 파일을 사용하면 소스를 직접 빌드할 필요는 없습니다.
운영할 때 보존할 것
.env 파일과 .local 폴더에는 설치 설정, DB와 암호화 키가 있습니다. 이를 삭제하면 일반적인 재설치만으로 자료를 복구할 수 없습니다.
서버를 변경하거나 다시 설치하기 전에 운영과 백업을 확인해 주세요.
고급 네트워크·자원 설정은 개발 안내에 있습니다. 이 설치 안내는 소규모 사용을 시작하는 방법이며 1,000대 운영 성능 보장은 아닙니다.
원문: 공개 소스 cedbd06. 문서 갱신일 2026-10-12.