원격 접근

VPS 또는 다른 머신에서 실행 중인 에이전트에서 보안 터널을 통해 SimpliGen에 접근합니다.

View as Markdown Open in ChatGPT Open in Claude

기본적으로 에이전트는 동일한 머신의 SimpliGen에 연결됩니다. 에이전트를 VPS처럼 다른 곳에서 실행하는 경우, 앱에 변경 없이 보안 터널을 통해 SimpliGen에 접근할 수 있습니다.

아이디어

SimpliGen의 제어 서비스는 안전을 위해 localhost에서만 수신합니다. 따라서 원격 머신의 localhost를 SimpliGen 머신의 localhost로 터널링하는 것입니다. SSH 역방향 터널이 정확히 이를 수행하며, SSH가 모든 암호화 및 인증을 처리합니다.

필요한 것

SimpliGen이 홈 머신에서 실행 중이고 페어링 토큰이 있어야 합니다(설정 -> 에이전트 연결 -> 수동 설정에서 생성).
제어 API 포트입니다. Windows에서는 %APPDATA%\simpligen\agent-api.json에 있으며, 예를 들어 48199입니다.
홈 머신에서 원격 머신으로의 SSH 접근.

터널 열기

홈 머신(SimpliGen이 실행되는 곳)에서 원격 머신으로의 역방향 터널을 엽니다. 48199를 포트로 바꾸고 user@your-vps를 서버로 바꾸세요:

ssh -N -R 48199:localhost:48199 user@your-vps

이는 원격 머신의 localhost:48199를 홈 머신의 localhost:48199로 포워드합니다. 에이전트가 작동하는 동안 실행 상태로 유지하세요.

에이전트가 이를 가리키도록 설정

원격 머신에서 에이전트의 MCP 서버를 토큰과 포트로 구성하세요:

{
  "mcpServers": {
    "simpligen": {
      "command": "npx",
      "args": ["-y", "@simpligen/mcp"],
      "env": {
        "SIMPLIGEN_TOKEN": "sg-agent-...",
        "SIMPLIGEN_API_PORT": "48199"
      }
    }
  }
}

SIMPLIGEN_API_PORT는 원격 머신에 SimpliGen 설치가 없어서 이를 감지할 수 없으므로 커넥터가 사용할 포트를 알려줍니다. 각 요청은 터널을 통해 홈 머신의 SimpliGen으로 이동합니다.

둘 다 실행 상태 유지

SimpliGen은 홈 머신에서 열려 있어야 하고, 터널은 유지되어야 합니다. 둘 중 하나라도 중단되면, 에이전트를 다시 시작할 때까지 에이전트가 연결을 잃습니다.

Tailscale 또는 개인 네트워크 사용

Tailscale같은 개인 메시 네트워크를 사용하는 경우, 동일한 SSH 역방향 터널을 이를 통해 실행하여 홈 라우터의 포트를 노출하지 않고 안정적인 연결을 얻습니다. 메커니즘은 동일합니다: 원격 머신의 localhost는 여전히 홈 머신의 localhost로 포워드됩니다.

보안에 대한 참고

터널이 양쪽 끝의 localhost에서 종료되므로, SimpliGen을 공개 인터넷에 노출하지 않습니다. SSH가 연결을 암호화하고 인증하며, 페어링 토큰이 에이전트를 인증합니다. 연결된 에이전트에서 언제든지 해당 토큰을 취소하여 접근을 차단할 수 있습니다.