터널 Agent 설치 (Docker)

# 태그는 인핸스가 전달한 버전으로 교체
docker pull commerceos/commerce-os-aos-tunnel:v0.64.0

sudo mkdir -p /etc/aostun
sudo chown 1001:1001 /etc/aostun
sudo chmod 0750 /etc/aostun

docker run --rm \
  -v /etc/aostun:/etc/aostun \
  commerceos/commerce-os-aos-tunnel:v0.64.0 \
  keygen --out /etc/aostun/agent.key

private key written to /etc/aostun/agent.key
public key (share this with AgentOS):
ed25519:vVWDYbxVei/V0J7cvWimVyMjD87qZqxVXtXUuWMwTIc=

docker run --rm -v /etc/aostun:/etc/aostun:ro \
  commerceos/commerce-os-aos-tunnel:v0.64.0 \
  pubkey --key /etc/aostun/agent.key

agent:
  id: tenant-42-dc1                    # 인핸스와 합의한 이름
  private_key_file: /etc/aostun/agent.key
 
gateway:
  base_url: wss://data-connector.commerceos.ai/api/tunnel   # SaaS. 온프렘은 인핸스가 전달한 주소
  server_public_key: "ed25519:XesZRGPrikrZ..."     # 관리 화면에서 복사 (테넌트별)
 
  # SSL 검사 장비가 있으면 사내 CA 를 지정
  # tls_ca_file: /etc/aostun/corp-ca.pem
  # 사내 프록시를 거쳐야 하면
  # http_proxy: "http://proxy.corp.local:8080"
 
egress:
  allow:                               # 여기 없는 목적지는 무조건 거부
    - cidr: 10.20.0.0/24          # 주소 규칙 — IP 리터럴만, 이름을 풀지 않음 (기존 동작 그대로)
      ports: [1521]
    - host: sap.corp.local        # 이름 규칙 — agent 가 고객사 DNS 로 풀어 dial
      ports: [44300]
    - host: "*.s4.corp.local"     # 한 레이블 이상 아래의 모든 이름 (bare 접미는 미포함)
      ports: [44300]
 
limits:
  max_connections: 16                  # 동시 접속 상한
  dial_timeout: 5s

sudo chown 1001:1001 /etc/aostun/agent.yaml
sudo chmod 0640 /etc/aostun/agent.yaml

curl -H "Authorization: Bearer $TOKEN" -H "X-Tenant-ID: $COMPANY_ID" \
  https://app-api-v2.commerceos.ai/tunnel/server-key | jq -r .data.publicKey   # 온프렘은 app-api 주소

services:
  aostun-agent:
    image: commerceos/commerce-os-aos-tunnel:v0.64.0
    container_name: aostun-agent
    restart: always
    # 사내망 라우팅이 호스트 인터페이스에 묶여 있으면 host 네트워크가 확실합니다.
    # bridge 로도 대개 동작하니, 막히면 아래 트러블슈팅을 보세요.
    network_mode: host
    read_only: true
    cap_drop: ["ALL"]
    security_opt: ["no-new-privileges:true"]
    volumes:
      - /etc/aostun:/etc/aostun:ro
    command: ["agent", "--config=/etc/aostun/agent.yaml", "--log-format=json"]
    logging:
      driver: json-file
      options: { max-size: "10m", max-file: "3" }

cd /etc/aostun && sudo docker compose up -d
sudo docker compose logs -f

sudo docker run -d --name aostun-agent --restart=always \
  --network host \
  --read-only --cap-drop ALL --security-opt no-new-privileges:true \
  --log-opt max-size=10m --log-opt max-file=3 \
  -v /etc/aostun:/etc/aostun:ro \
  commerceos/commerce-os-aos-tunnel:v0.64.0 \
  agent --config=/etc/aostun/agent.yaml --log-format=json

agent starting   agent_id=tenant-42-dc1 gateway=wss://... pool_size=16
                 egress_allow="[10.20.0.0/24 ports=[1521]]"
tunnel established  agent_id=tenant-42-dc1 tenant_id=42 session_id=... pool_size=16

sudo docker run --rm --network bridge busybox \
  timeout 5 nc -zv 10.20.0.5 1521

# 인터넷이 되는 곳에서
docker pull commerceos/commerce-os-aos-tunnel:v0.64.0
docker save commerceos/commerce-os-aos-tunnel:v0.64.0 | gzip > aostun-v0.64.0.tar.gz
sha256sum aostun-v0.64.0.tar.gz          # 전달 후 대조
 
# 사내 VM 에서
sha256sum aostun-v0.64.0.tar.gz
gunzip -c aostun-v0.64.0.tar.gz | sudo docker load

# 1. 이미지
docker pull commerceos/commerce-os-aos-tunnel:v0.64.0
 
# 2. 디렉토리 (소유자 1001 이 중요)
sudo mkdir -p /etc/aostun && sudo chown 1001:1001 /etc/aostun && sudo chmod 0750 /etc/aostun
 
# 3. 키쌍 — 출력된 공개키를 인핸스에 전달
docker run --rm -v /etc/aostun:/etc/aostun \
  commerceos/commerce-os-aos-tunnel:v0.64.0 keygen --out /etc/aostun/agent.key
 
# 4. /etc/aostun/agent.yaml 작성 후
sudo chown 1001:1001 /etc/aostun/agent.yaml && sudo chmod 0640 /etc/aostun/agent.yaml
 
# 5. 실행
cd /etc/aostun && sudo docker compose up -d
 
# 6. 확인 — "tunnel established" 가 보이면 완료
sudo docker compose logs -f