직원 PC를 타워에 연결하기

에이전트는 직원 PC의 파일을 검사하고 결과를 타워로 보냅니다. 이 안내는 설치를 준비하는 IT 담당자와 직원 모두를 위한 문서입니다.

먼저 확인하세요

공개 에이전트 0.2.40은 로그인 없이 받을 수 있습니다. 사용 중인 OS와 CPU에 맞는 파일을 선택해 주세요. 공개 설치 파일을 사용하면 소스를 직접 빌드하지 않아도 됩니다.

직원 PC	처음 설치할 파일
Windows x64	Windows 설치 EXE
Apple Silicon Mac · ARM64	macOS ARM64 전체 ZIP
Intel Mac · x64	macOS x64 전체 ZIP
Linux x64	Linux x64 전체 ZIP
Linux ARM64	Linux ARM64 전체 ZIP

전체 ZIP에는 실행 파일, OCR 실행 라이브러리와 모델, 브랜드 아이콘, 라이선스가 들어 있습니다.

macOS·Linux의 공개 ZIP은 프로그램 파일을 모은 패키지입니다. 회사별 설치 실행기가 포함된 등록 ZIP은 타워에서 따로 만듭니다. IT 담당자는 아래 순서로 공개 파일을 타워에 배치한 뒤 등록 ZIP을 준비해 주세요.

Windows 설치 파일에는 회사 타워 주소를 입력합니다. 등록 키가 없다면 설치 후 직원 창에서 입력할 수 있습니다. 등록 키를 입력하기 전에는 회사 서버에 등록되지 않습니다.

타워 사이드바에 다운로드가 보이지 않는다면 에이전트 파일을 서버에 배치했는지 확인해 주세요. 직원 PC에는 에이전트를 설치합니다. 타워 EXE는 서버 PC용 프로그램입니다.

관리자: 공개 파일을 타워에 배치하기

1. 같은 에이전트 릴리즈의 첨부파일 15개를 받습니다. Windows 설치 EXE, OS별 실행 파일·ZIP, 메일 게이트 2종, VERSION, SHA256SUMS를 포함합니다.
2. SHA256SUMS에 적힌 체크섬과 내려받은 파일의 값을 비교합니다.

Linux에서는 파일을 모은 폴더에서 sha256sum -c SHA256SUMS를 실행합니다. macOS에서는 shasum -a 256 -c SHA256SUMS를 사용합니다. 이 검사는 체크섬 목록의 모든 파일이 있어야 통과합니다.

Windows에서는 PowerShell의 Get-FileHash <파일> -Algorithm SHA256 결과를 해당 파일의 체크섬과 비교합니다.

배치할 위치는 설치 방식에 따라 다릅니다.

• Docker: 저장소의 dist/agent에 파일을 넣습니다.
• Windows 타워 EXE: 트레이에서 데이터 폴더를 열고, 그 안의 agent에 파일을 넣습니다.

하위 폴더를 만들지 않고 릴리즈의 파일 이름을 그대로 유지해 주세요. VERSION과 SHA256SUMS도 함께 넣습니다.

배치 후에는 다음 순서로 확인합니다.

1. 타워 사이드바에서 버전과 OS·CPU별 다운로드가 표시되는지 확인합니다.
2. 에이전트 등록에서 등록 키를 선택합니다.
3. 직원에게 전달할 설치 파일을 만듭니다.

서명되지 않은 Windows 설치 파일에는 SmartScreen 확인이 나올 수 있습니다. 파일 출처와 체크섬을 확인하고 회사의 설치 승인 절차를 따릅니다. 검증 결과와 남은 설치 확인

관리자: 설치 준비하기

1. 직원이 사용할 서버 주소를 정합니다. 예: https://192.168.1.50:8443.
2. 타워의 에이전트 등록 → 새 등록 키에서 키를 만듭니다. 필요한 사용 수·만료·사내 네트워크 범위를 설정합니다.
3. 직원 PC가 서버의 공개 인증서(CA)를 신뢰하도록 준비합니다.
4. 준비한 OS별 설치 파일과 연결 정보를 직원에게 전달합니다.

등록 키는 새 PC를 회사 서버에 처음 연결할 때 사용하는 비밀 값입니다. 서버 관리자 키와는 다릅니다.

등록을 마친 PC는 자신에게 발급된 인증 정보로 통신합니다. 등록 키를 폐기해도 이미 등록된 PC의 통신이 자동으로 끊기지는 않습니다.

인증서 준비

Windows EXE 타워의 공개 CA는 서버에서 https://localhost:8443/setup/ca.crt로 받을 수 있습니다. Docker 타워는 서버의 .local/tls/ca.crt를 사용합니다. 공개 CA 파일만 직원 PC로 전달합니다.

직원 PC	인증서를 등록할 곳
Windows 설치형 서비스	로컬 컴퓨터의 ‘신뢰할 수 있는 루트 인증 기관’
macOS	회사 관리 절차에 따른 키체인
Linux	사용하는 배포판의 신뢰 인증서 저장소

Windows 인증서 가져오기 화면에서는 로컬 컴퓨터를 선택해 주세요. 에이전트의 SYSTEM 서비스가 이 인증서를 사용합니다.

현재 사용자에게만 등록하면 브라우저는 열리더라도 서비스 연결이 실패할 수 있습니다. IT 담당자가 인증서의 발급자를 확인한 뒤 설치해 주세요.

직원: OS에 맞게 설치하기

PC 종류	사용할 파일·방법
Windows x64	Windows 설치 프로그램 실행. 회사 타워 주소와 등록 키를 입력하고 관리자 확인을 진행합니다.
Apple Silicon Mac	타워 사이드바에서 macOS ARM64와 등록 키를 선택한 설치 ZIP 사용
Intel Mac	macOS x64와 등록 키를 선택한 설치 ZIP 사용
Linux	x64 또는 ARM64와 등록 키를 선택한 설치 ZIP 사용

타워에서 만든 macOS·Linux 등록 ZIP은 압축을 푼 뒤 포함된 설치 실행기를 사용합니다. Apple Silicon Mac은 ARM64, Intel Mac은 x64 패키지를 선택해 주세요.

처음 설치할 때는 OCR이 포함된 전체 패키지가 필요합니다.

연결됐는지 확인하기

설치가 끝나면 타워의 자산 관리를 열어 주세요. PC 이름, OS, 에이전트 버전과 마지막 신호가 표시되면 연결 상태를 확인할 수 있습니다.

직원 화면은 트레이나 로컬 브라우저에서 엽니다. 이제 첫 점검을 진행해 보세요.

종료와 제거

Windows 설치형은 검사 서비스와 직원 창이 따로 동작합니다. 창을 닫는 것과 검사 서비스를 제거하는 것은 다릅니다.

Windows 설치형은 타워의 자산 상세에서 제거 승인을 확정하면 자동으로 제거됩니다. 해당 PC가 유효한 승인 명령을 확인해야 실행됩니다.

오프라인 PC는 승인 유효시간인 15분 안에 다시 연결되어야 합니다. 타워에서 제거 완료, 실패, 파일 정리 대기 중 실제 결과를 확인해 주세요. macOS와 Linux에는 같은 Windows 서비스 제거 방식을 제공하지 않습니다.

지원 범위 · 연결 문제 · 전체 안내

원문: 공개 소스 cedbd06. 문서 갱신일 2026-10-12.