메인 콘텐츠로 건너뛰기
Tokios 커넥터는 모델이 있는 기기에서 실행하는 소형 콘솔 앱입니다. 단일 WebSocket으로 Tokios에 연결하고 요청을 로컬 모델에 전달합니다. 인바운드 포트, 공용 IP, 방화벽 변경이 필요 없습니다. 콘솔의 Setup wizard 에서 일회용 페어링 코드로 설치 및 페어링을 진행합니다. 기본 경로에서는 설정 파일을 직접 편집하지 않습니다. 기기를 승인한 후 커넥터가 터널을 통해 토큰을 안전하게 수신합니다.

​
1. 페어링 코드 받기

콘솔의 Setup 탭에서 Start pairing을 클릭합니다 (1단계). Tokios에서 TKS-XXXX-XXXX와 같은 페어링 코드를 표시하며, 약 15분간 유효합니다. 탭을 연 상태로 유지하세요.

​
2. 커넥터 설치 및 실행

모델이 있는 기기에서 콘솔에 표시된 OS용 원라이너를 실행하세요.
Windows 10 및 11 (x64). PowerShell에서 실행하세요:
이미 tokios-connector가 설치되어 있나요? 설치 프로그램을 건너뛰고 페어링 코드를 직접 전달하세요:

​
3. 기기 승인

커넥터가 연결되어 콘솔에 나타납니다. Setup 탭(또는 Connectors 탭)에서 기기를 approve합니다. Tokios가 터널을 통해 커넥터의 토큰을 전달합니다. 토큰은 화면에 표시되지 않으며 파일에 붙여넣지도 않습니다.
커넥터는 아웃바운드 연결만 수행하며 포트에서 수신하지 않으므로 방화벽에 인바운드 규칙이 필요 없습니다.
연결이 완료되면 모델 등록 및 API 키 생성을 진행하세요.

​
고급 기능: 설정 파일로 여러 모델 노출

하나의 커넥터로 여러 모델을 제공하려면 단일 모델 페어링 대신 각 업스트림을 정의하는 JSON 설정으로 커넥터를 실행하세요. 자세한 내용은 Connector Config를 참고하세요.

​
설치 프로그램이 기기에서 변경하는 내용

  • 설치 디렉터리. 커넥터 바이너리와 tokios-connector.json은 ~/.tokios/connector(macOS 및 Linux) 또는 %LOCALAPPDATA%\Tokios\connector(Windows)에 함께 저장됩니다. --dir / -InstallDir을 전달하여 다른 폴더를 선택하세요.
  • PATH. macOS 및 Linux에서 설치 프로그램은 바이너리를 ~/.local/bin에 심볼릭 링크하고, 해당 폴더가 PATH에 없으면 # tokios-connector PATH로 표시된 1줄을 셸 프로필(.zshrc, .bashrc 또는 .profile)에 추가합니다. 동일한 줄을 두 번 추가하지 않으며, 수행한 내용을 출력하고, 다른 도구에서 동일한 폴더를 사용할 수 있으므로 제거 시에도 해당 줄이 유지됩니다. 취소하려면 해당 줄을 삭제하세요. Windows에서는 기본 설치 폴더를 사용자 Path에 추가하며, tokios-install -Uninstall로 제거합니다. 이 모든 과정을 건너뛰려면 --no-path / -NoPath를 전달하세요.
  • 이 외에는 없습니다. 시스템 서비스, sudo, 방화벽 규칙은 없습니다.

​
부팅 시 커넥터 실행

설치 프로그램은 커넥터를 포그라운드로 시작하거나, --detach / -Detach로 백그라운드에서 시작합니다. 어느 쪽도 재부팅 후 유지되지 않습니다. 재시작 후에도 모델을 계속 연결하려면 플랫폼의 서비스 관리자에서 커넥터를 실행하세요. 커넥터는 설치 디렉터리당 1개의 인스턴스만 실행할 수 있으므로, 먼저 백그라운드 프로세스를 중지하세요:
~/.config/systemd/user/tokios-connector.service
커넥터는 페어링 정보를 tokios-connector.json에 보관하므로, 재부팅 후 서비스로 시작하면 새 페어링 코드 없이 다시 연결됩니다.