mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-09-29 22:06:38 +08:00
ryan
120 lines
5.0 KiB
Markdown
120 lines
5.0 KiB
Markdown
# 部署 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` 二进制运行时，无需额外搭建环境。
|
|
|
|
```bash
|
|
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. 编译二进制
|
|
|
|
```bash
|
|
cd openflared
|
|
go build -o flared ./cmd/flared
|
|
```
|
|
|
|
### 2. 准备 `flared.json`
|
|
|
|
在程序同级目录下创建 `flared.json` 配置文件：
|
|
|
|
```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. 运行服务
|
|
|
|
```bash
|
|
export LOG_LEVEL='info'
|
|
./flared -config ./flared.json
|
|
```
|
|
|
|
---
|
|
|
|
## 启动与验证
|
|
|
|
### 1. 自动同步逻辑
|
|
|
|
启动成功后，OpenFlared 将执行以下工作流：
|
|
- **心跳与配置获取**：周期性向 Server 的 `/api/flared/heartbeat` 和 `/api/flared/config` 接口发起同步，验证 Token 并检测配置版本。
|
|
- **文件渲染**：当检测到配置版本（或校验和 Checksum）变化时，会自动拉取该隧道的完整路由规则。如果绑定了多个中继 Relay，将为每个 Relay 分别在 `data_dir` 下渲染出 `frpc_{relayNodeID}.toml`。
|
|
- **热重载或重启**：拉起对应的 `frpc` 子进程，或在配置文件发生改变时执行 `frpc reload` / 重启动作，以确保流量映射保持最新。
|
|
- **异常自恢复**：如果本地 `frpc` 隧道进程异常退出，主控程序会在 5 秒的退避惩罚后自动尝试重新启动。
|
|
|
|
### 2. 查看日志与连接状态
|
|
|
|
```bash
|
|
# Docker 容器日志
|
|
docker logs -f openflared
|
|
```
|
|
|
|
若进程运行无误，您会在日志中看到类似如下输出：
|
|
```text
|
|
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. 管理端确认
|
|
|
|
打开管理后台的 **「内网穿透」** 页面：
|
|
- 查看对应隧道的在线状态，此时应当绿灯显示 **「在线」**。
|
|
- 您可以清晰地看到该隧道目前连接了哪些中继节点，以及各内网服务的穿透路由详情。
|