部署 OpenFlared 客户端

你会学到：OpenFlared 客户端的职责、配置参数与环境变量、基于 Docker 运行客户端的方法，以及如何在内网服务器上通过二进制方式独立部署。

OpenFlared 是部署在用户内网（局域网、私有云等无法被公网直接访问的环境）的隧道客户端。它的核心职责是通过 X-Tunnel-Token 与控制面（OpenFlare Server）建立通信，并在本地自动拉起并管理一个或多个 frpc (快速反向代理客户端) 进程，从而将内网的 HTTP 流量安全、稳定地穿透至外网的中继节点。

---

前置条件

1. 获取 Tunnel Token：在 OpenFlare 管理端的「内网穿透」或「隧道管理」页面中，创建一个新的隧道实例，系统会自动生成唯一的 tunnel_id 与 tunnel_token（形如 tun-<32hex>）。
2. 网络出方向权限：内网服务器无需任何公网入方向 IP 或端口映射，但必须能够通过网络访问公网上的 OpenFlare Server 地址 以及对应的 TunnelRelay 节点中继端口 (默认 7000)。
3. 软件依赖（仅限宿主机直接部署）：
   • 本地需有可执行的 frpc 二进制文件（建议版本为 v0.61.0+ 或最新稳定版 v0.69.0），或通过参数显式指定路径。

---

配置文件与环境变量

openflared 启动时默认会读取当前目录下的 flared.json。同时也完全支持通过环境变量进行覆盖。

配置字段详情

JSON 字段	环境变量	说明	默认值
server_url	OPENFLARE_SERVER_URL	OpenFlare Server 接口服务地址	无（必填）
tunnel_token	OPENFLARE_TUNNEL_TOKEN	隧道客户端专属认证 Token	无（必填）
frpc_path	OPENFLARE_FRPC_PATH	frpc 可执行二进制文件路径	"frpc"
data_dir	OPENFLARE_DATA_DIR	本地数据与生成的 frpc_{relayNodeID}.toml 存放目录	"./data"
state_path	-	本地状态记录文件路径（保存最后应用的配置版本）	"{data_dir}/flared-state.json"
heartbeat_interval	-	状态心跳上报周期（支持毫秒数或 Go Duration 字符串）	10000 (10s)
sync_interval	-	隧道配置拉取同步周期（支持毫秒数或 Go Duration 字符串）	30000 (30s)
request_timeout	-	接口网络请求超时时长	10000 (10s)

---

Docker 运行（推荐）

Docker 部署是内网运行最简单也最安全的方式。官方的 openflared 镜像已经内置了客户端控制器以及 frpc v0.69.0 二进制运行时，无需额外搭建环境。

docker pull ghcr.io/rain-kl/openflared:latest
docker rm -f openflared 2>/dev/null || true

docker run -d --name openflared --restart unless-stopped \
  -e OPENFLARE_SERVER_URL=http://your-server:3000 \
  -e OPENFLARE_TUNNEL_TOKEN=YOUR_TUNNEL_TOKEN \
  -v openflared-data:/app/data \
  ghcr.io/rain-kl/openflared:latest

---

宿主机手动运行

如果您需要直接在内网的 Linux/macOS/Windows 宿主机上独立运行：

1. 编译二进制

go build -o bin/flared ./cmd/flared

2. 准备 flared.json

在程序同级目录下创建 flared.json 配置文件：

{
  "server_url": "http://your-server-ip:3000",
  "tunnel_token": "your-tunnel-auth-token",
  "frpc_path": "/usr/local/bin/frpc",
  "data_dir": "./data",
  "heartbeat_interval": "10s",
  "sync_interval": "30s"
}

3. 运行服务

export LOG_LEVEL='info'
./flared -config ./flared.json

---

启动与验证

1. 自动同步逻辑

启动成功后，OpenFlared 将执行以下工作流：

• 心跳与配置获取：周期性向 Server 的 /api/v1/tunnel/heartbeat 和 /api/v1/tunnel/config/active 接口发起同步，验证 Token 并检测配置版本。
• 文件渲染：当检测到配置版本（或校验和 Checksum）变化时，会自动拉取该隧道的完整路由规则。如果绑定了多个中继 Relay，将为每个 Relay 分别在 data_dir 下渲染出 frpc_{relayNodeID}.toml。
• 热重载或重启：拉起对应的 frpc 子进程，或在配置文件发生改变时执行 frpc reload / 重启动作，以确保流量映射保持最新。
• 异常自恢复：如果本地 frpc 隧道进程异常退出，主控程序会在 5 秒的退避惩罚后自动尝试重新启动。

2. 查看日志与连接状态

# Docker 容器日志
docker logs -f openflared

若进程运行无误，您会在日志中看到类似如下输出：

flared config loaded ...
detected frpc version v0.69.0
flared process started
applying new tunnel config {"version": "...", "checksum": "..."}
frpc process missing, starting {"relay_id": "..."}

3. 管理端确认

打开管理后台的 「内网穿透」 页面：

• 查看对应隧道的在线状态，此时应当绿灯显示 「在线」。
• 您可以清晰地看到该隧道目前连接了哪些中继节点，以及各内网服务的穿透路由详情。