Docker 运行

前置说明

• 支持架构：该镜像适配 linux/386、linux/amd64、linux/arm/v7、linux/arm64、linux/s390x 架构，可根据宿主机系统选择对应版本（默认 latest 会自动匹配）。

• 网络模式：示例中使用 host 网络模式（直接使用宿主机网络），若需自定义端口映射，需调整网络配置并确保服务端端口开放。

方式 1：Docker Compose 部署（推荐）

创建 docker-compose.yml 文件

version: "3"
services:
  client:
    image: sianhh/gostc:latest 
    restart: always
    network_mode: host
    container_name: gostc
    command:
      - --tls=true # 根据服务端是否使用ssl决定
      - -addr
      - gostc.caiyunup.top # 服务端地址
      - -key
      - ******   # 这里需要把******替换为客户端的KEY，客户端的KEY在网页新建客户端后可以获取到

启动容器

# 启动（后台运行）
docker-compose up -d

# 查看日志（验证是否连接成功）
docker-compose logs -f gostc

# 停止/删除容器
docker-compose down

方式 2：直接运行 Docker 容器

# ******替换为客户端的连接密钥
docker run -d --name gostc --net host --restart always sianhh/gostc:latest --tls=true -addr gostc.caiyunup.top -key ******

常见问题解决

1. 镜像拉取失败 镜像拉取（若拉取失败，手动下载：gostc.tar）。

• 手动下载 gostc.tar 后，执行 docker load -i gostc.tar 加载镜像，再将 docker-compose.yml/ 运行命令中的 image 改为 gostc。

1. 连接失败

• 验证客户端 KEY（-key）是否正确，无多余空格 / 符号。

• 宿主机防火墙 / 安全组需放行服务端端口。

1. 容器重启异常

• 查看容器日志：docker logs gostc。

• 检查宿主机网络是否正常（ping 服务端地址）。

• 若 host 网络模式不兼容，可改用端口映射（需服务端支持）：