Skip to Content
OpenFlare
使用指南安装部署技术参考架构设计更新日志

配置项

你会学到:OpenFlare Server、前端构建、Agent、Relay、OpenFlared 支持哪些配置来源、有哪些配置字段和环境变量,以及它们的默认值和行为。

本文档汇总了 OpenFlare 当前版本所支持的全部配置项。


配置来源

1. Server 配置来源

  • 配置文件:启动时默认读取同级目录下的 config.yaml(可通过 CONFIG_PATH 环境变量指定)。
  • 环境变量:所有配置文件中的字段均支持通过大写蛇形(UPPER_SNAKE_CASE)的环境变量进行覆盖(环境变量优先级高于 config.yaml)。
  • 系统运行时配置:保存在关系数据库的 w_system_configs 表中。此类参数可通过管理后台图形界面或系统 API 热更新并动态生效。

2. Agent / Relay / OpenFlared 配置来源

  • 命令行参数:通过 -config 指定配置文件(JSON 格式)。
  • 配置文件:例如 relay.json、flared.json。
  • 覆盖环境变量:支持特定的环境变量来覆盖配置文件中的连接地址和 Token 凭证。

配置文件与状态文件位置

组件默认位置说明
Server 配置文件./config.yaml可通过 CONFIG_PATH 环境变量修改
Server SQLite 库openflare.db可通过 database.sqlite_path / SQLITE_PATH 修改
Agent 配置文件./agent.json可通过 -config 指定
一键安装 Agent 配置/opt/openflare-agent/agent.json安装脚本默认生成路径
Agent 数据目录配置文件同级 data可在配置文件中通过 data_dir 覆盖
Relay 配置文件./relay.json可通过 -config 指定
一键安装 Relay 配置/opt/openflare-relay/relay.json安装脚本默认生成路径
Relay 运行时状态文件<data_dir>/relay-state.json运行时自动维护于数据目录,记录中继节点注册与运行状态
Client 配置文件./flared.json可通过 -config 指定
一键安装 Client 配置/opt/openflared/flared.json安装脚本默认生成路径
Client 运行时状态文件<data_dir>/flared-state.json运行时自动维护于数据目录,记录隧道会话与连接状态

Server 命令行参数

# 启动 Server 时指定配置文件
CONFIG_PATH=/path/to/custom-config.yaml ./bin/openflare-server all

运行支持的子服务指令(融合/单进程模式):

  • all:在一进程内启动所有服务(API + Worker + Scheduler,默认)。
  • api:仅启动管理端与节点通信的 API 服务。
  • worker:仅启动后台任务的 Asynq Worker 服务。
  • scheduler:仅启动定时任务的 Scheduler 调度服务。
  • reset-passwd:重置指定管理员或用户的登录密码(支持 --user 与 --password 参数)。

Server 环境变量与配置文件对照

Server 的所有核心基础配置定义在 config.yaml 中,且均支持环境变量覆盖(变量优先级高于 YAML 配置文件)。

1. 应用基本配置 (app:)

配置文件 YAML 路径对应覆盖环境变量作用说明默认值
app.app_nameAPP_NAME应用程序标识名称openflare
app.envAPP_ENV运行环境(development / testing / production)production
app.addrAPP_ADDR服务监听地址与端口:3000
app.node_idAPP_NODE_IDSnowflake 算法的节点 ID(0-1023),多实例部署时必须唯一1
app.api_prefixAPP_API_PREFIX管理端与 API 的路由前缀/api
app.graceful_shutdown_timeoutAPP_GRACEFUL_SHUTDOWN_TIMEOUT优雅停机等待超时(秒)30
app.session_cookie_nameAPP_SESSION_COOKIE_NAME会话 Cookie 的名称openflare_session_id
app.session_secretAPP_SESSION_SECRETSession 会话签名的密钥,生产环境必须配置为随机长字符串无(随机)
app.session_domainAPP_SESSION_DOMAIN共享 Session 的 Cookie 作用域域名空
app.session_ageAPP_SESSION_AGE浏览器 Session 的存活时间(秒)86400 (24h)
app.session_http_onlyAPP_SESSION_HTTP_ONLY是否启用 Cookie 的 HttpOnly 属性false
app.session_secureAPP_SESSION_SECURE是否启用 Cookie 的 Secure 属性(HTTPS 下使用)false

2. 关系数据库配置 (database:)

配置文件 YAML 路径对应覆盖环境变量作用说明默认值
database.enabledDB_ENABLED是否启用 PostgreSQL 数据库。设为 false 则回退到 SQLitetrue
database.sqlite_pathSQLITE_PATHPostgreSQL 禁用时,SQLite 数据库的文件路径openflare.db
database.hostDB_HOSTPostgreSQL 数据库连接地址127.0.0.1
database.portDB_PORTPostgreSQL 数据库端口5432
database.usernameDB_USERNAMEPostgreSQL 数据库用户名openflare
database.passwordDB_PASSWORDPostgreSQL 数据库密码replace-with-strong-password
database.databaseDB_NAMEPostgreSQL 数据库名openflare
database.max_idle_connDB_MAX_IDLE_CONN数据库连接池最大空闲连接数16
database.max_open_connDB_MAX_OPEN_CONN数据库连接池最大打开连接数128
database.conn_max_lifetime-连接最大存活时间(秒)1800
database.conn_max_idle_time-空闲连接最大空闲时间(秒)600
database.log_levelDB_LOG_LEVELGORM SQL 打印日志等级(info / warn / error / silent)info
database.ssl_modeDB_SSL_MODEPostgreSQL 的 SSL 模式disable
database.time_zoneDB_TIMEZONE数据库会话时区UTC
database.application_name-数据库连接应用标识名称openflare-server
database.search_path-PostgreSQL Schema 搜索路径public
database.prefer_simple_protocol-是否优先使用简单查询协议false
database.statement_cache_capacity-预编译 SQL 语句缓存容量256
database.default_query_exec_mode-查询默认执行模式cache_statement
database.slow_threshold-慢查询记录阈值(Duration)200ms

SQLite 文件数据库在启动时自动启用 WAL 模式;内存数据库保留 memory 模式。请确保数据库所在目录可写,以创建 -wal 和 -shm 文件。在线备份请使用管理端数据库导出(生成一致性快照),不要仅复制运行中的 .db 文件。

3. Redis 配置 (redis:)

配置文件 YAML 路径对应覆盖环境变量作用说明默认值
redis.enabledREDIS_ENABLED是否启用 Redis 服务。系统异步队列和同步依赖它,必须开启true
redis.addrsREDIS_ADDRRedis 单机或集群连接地址数组(环境变量仅设置单地址)["127.0.0.1:6379"]
redis.usernameREDIS_USERNAMERedis 账号名称(若有)空
redis.passwordREDIS_PASSWORDRedis 访问密码空
redis.dbREDIS_DBRedis 逻辑数据库编号0
redis.cluster_mode-是否启用 Redis 集群模式false
redis.master_name-Sentinel 哨兵模式下的主节点名称(非空时启用哨兵)空
redis.key_prefixREDIS_KEY_PREFIX系统在 Redis 中使用的键前缀openflare:
redis.pool_sizeREDIS_POOL_SIZERedis 连接池大小100
redis.min_idle_conn-最小空闲连接数10
redis.dial_timeout-建立连接超时时间(秒)5
redis.read_timeout-读取数据超时时间(秒)3
redis.write_timeout-写入数据超时时间(秒)3
redis.max_retries-命令失败重试次数3
redis.pool_timeout-连接池获取超时时间(秒)4
redis.conn_max_idle_time-空闲连接最大存活时间(秒)300
redis.maint_notificationsREDIS_MAINT_NOTIFICATIONS启动时是否启用 Redis maintenance notifications 自动协商;兼容性不明时保持关闭,修改后需重启false

4. ClickHouse 配置 (clickhouse:)

说明:下列为 OpenFlare 客户端连接参数。ClickHouse 服务端小规格调优:使用本地 ./config/clickhouse/performance.xml,并以单文件挂载方式映射至容器内 /etc/clickhouse-server/config.d/performance.xml,详见 启动 Server。

配置文件 YAML 路径对应覆盖环境变量作用说明默认值
clickhouse.enabledCLICKHOUSE_ENABLED是否启用 ClickHouse。系统节点指标与访问日志在此进行海量写入。默认关闭:缺失本配置项或为 false 时不启用,日志/指标由主库承担;显式 true 或设置 CLICKHOUSE_HOST 时启用false
clickhouse.hostsCLICKHOUSE_HOSTClickHouse 集群连接地址数组(环境变量仅设置单地址)["127.0.0.1:9000"]
clickhouse.usernameCLICKHOUSE_USERNAMEClickHouse 账号用户名default
clickhouse.passwordCLICKHOUSE_PASSWORDClickHouse 密码replace-with-clickhouse-password
clickhouse.databaseCLICKHOUSE_NAMEClickHouse 存储的数据库名称openflare
clickhouse.max_idle_conn-客户端空闲连接数(小规格默认偏低)8
clickhouse.max_open_conn-客户端最大打开连接数16
clickhouse.conn_max_lifetime-连接最大存活时间(秒)3600
clickhouse.dial_timeout-建连超时(秒)5
clickhouse.block_buffer_size-原生协议 block 缓冲行数32

5. 系统日志配置 (log:)

配置文件 YAML 路径对应覆盖环境变量作用说明默认值
log.levelLOG_LEVEL全局日志记录等级(debug / info / warn / error / fatal)info
log.formatLOG_FORMAT日志打印格式(console 易读控制台 / json 结构化)console
log.outputLOG_OUTPUT日志输出渠道(stdout 标准输出 / file 文本文件)stdout
log.file_path-当 output 为 file 时日志的持久化路径./logs/app.log
log.max_size-单个日志文件的最大空间(MB),超出自动切割轮转100
log.max_age-历史切割日志文件最大保留天数30
log.max_backups-历史切割日志文件保留的最大文件数量10
log.compress-是否对切割后的历史日志文件进行 gzip 压缩true

Server、Agent、调度器、任务框架及存储维护等运行时日志的固定描述使用英文,便于跨语言排障和检索。界面语言切换不会改变终端日志和 OTel 异常;接口错误、任务执行详情与内置元数据在展示时按语言翻译,历史记录不回写。用户配置名称及第三方错误保留原文,可能包含中文。现有日志格式、级别、参数及输出渠道保持不变,详见 运行时语言与国际化。

6. 异步任务 Worker 配置 (worker:)

配置文件 YAML 路径对应覆盖环境变量作用说明默认值
worker.concurrencyWORKER_CONCURRENCYAsynq Worker 并发消费处理任务的最大协程数20
worker.strict_priorityWORKER_STRICT_PRIORITY是否启用严格队列优先级调度(开启后仅在高优先级队列为空时才处理低优先级队列)false
worker.queues-消费队列名称与优先级列表webhook: 10, whitelist_only: 5, default: 3

7. 链路追踪 OpenTelemetry 配置 (otel:)

配置文件 YAML 路径对应覆盖环境变量作用说明默认值
otel.export_protocolOTEL_EXPORTER_OTLP_TRACES_PROTOCOL / OTEL_EXPORTER_OTLP_PROTOCOLOTLP 导出协议(grpc 或 http/protobuf)grpc
otel.sampling_rateOTEL_SAMPLING_RATEOTel 链路追踪全局采样率。默认 0.0 不采样,1.0 为全量追踪0.0
otel.tracer_nameOTEL_TRACER_NAME全局 OTel 埋点 Tracer 的实例化名称github.com/Rain-kl/OpenFlare

运行时系统配置 (SystemConfig)

这些配置项存储于关系型数据库中的 w_system_configs 表中。所有的配置项在修改后会主动通知 Redis 缓存失效以实现动态热更新,管理员可通过后台页面直接管理。

1. 基础与业务运行时配置

配置键 (Key)数据类型作用说明默认值
site_namestring管理端平台的展示名称OpenFlare
server_addressstring管理端控制台的对外公网访问地址,用于组装 OAuth 回调与下载链接空
password_login_enabledbool是否允许管理员通过常规用户名密码方式登录后台true
registration_enabledbool是否允许自助注册新用户(默认禁止,需由 root 账户邀请或分发)false
password_register_enabledbool是否允许通过邮箱/密码方式在前端直接注册false
oidc_login_enabledbool是否启用 OIDC (SSO) 第三方免密登录方案true
max_api_keys_per_userint每个后台用户可生成的最大 API 密钥(API Token)数量5
login_session_ttl_hoursint用户会话在浏览器 Cookie 中的有效期(小时)。0 为随浏览器关闭清除0
upload_allowed_extensionsstring允许上传的文件扩展名(逗号分隔,空则不限)jpg,png,webp
file_access_whitelistjson允许免登录直接公开下载或访问的文件业务类型列表 (JSON 数组)["avatar"]
disk_cache_max_size_mbint平台本地磁盘缓存的最大存储阈值(MB)100
disk_cache_ttl_minutesint本地磁盘缓存对象的默认生存周期(分钟)60
disk_cache_lru_enabledbool当本地磁盘缓存空间不足时是否启用 LRU 算法剔除最旧缓存true
update_upstream_repositorystring系统检测自更新的 GitHub 仓库地址Rain-kl/OpenFlare
storage_configjson对象存储的结构化配置 (JSON),支持本地磁盘与 AWS S3 兼容存储配置本地存储模式
relay_frps_web_ui_enabledbool是否在中继节点上开启内嵌的 frps 流量监视面板 Web UIfalse
relay_frps_web_ui_portint中继节点 frps 监视面板所监听绑定的宿主机端口17500
search_engine_indexing_enabledbool是否允许搜索引擎爬取/检索该站点false
menu_display_configstring目录显示的结构化配置 (JSON 字符串,格式为 {url: enabled}){}
pages_max_package_size_mbintPages 部署包上传大小上限(MiB,范围 1~2048)100
pages_max_history_countintPages 每个项目最大历史部署保留数(0 表示不限制)20

2. 人机安全校验 (PoW Captcha)

配置键 (Key)数据类型作用说明默认值
cap_login_enabledbool是否在登录界面强制要求进行本地 PoW 算力防爆破人机验证false
cap_auto_solvebool打开页面后是否由浏览器自动开始后台背景计算算力(无需用户手动点击)true
cap_challenge_countint人机验证所需的计算难题数。数量越大,计算要求时间越长(推荐 1~5)1
cap_challenge_difficultyint每次计算所需的 PoW 哈希前缀匹配难度。推荐数值在 3-5 之间4
cap_challenge_sizeint人机验证盐值长度32
cap_challenge_ttl_secondsint难题下发后等待计算提交的最长有效时间(秒),超时自动作废600
cap_token_ttl_secondsint完成计算并置换到登录凭证后的有效期(秒),限制需在规定时间内登录1200

3. SMTP 邮件推送配置

配置键 (Key)数据类型作用说明默认值
smtp_hoststring发信 SMTP 邮件服务器的连接地址空
smtp_portint发信 SMTP 服务的端口 (通常是 465 SSL 或 587 STARTTLS)465
smtp_usernamestringSMTP 账户发信邮箱名称空
smtp_passwordstringSMTP 账户的授权密码或证书密钥(后台写入后加密隐藏,不可回显)空
email_login_verification_enabledbool是否在用户邮箱登录时发送一次性 6 位动态验证码进行二次认证false
email_register_verification_enabledbool用户自助注册时是否必须强制验证邮箱真实性并收取注册验证码false

4. 节点与 Agent 运维运行时参数

配置键 (Key)数据类型作用说明默认值
agent_discovery_tokenstring新节点首次一键接入并自动注册的全局通用验证发现 Token无(首次访问时自动生成)
agent_heartbeat_intervalint控制并向所有接入 Agent 周期下发的标准心跳检测间隔(毫秒)3000 (3s)
agent_websocket_upgrade_enabledbool是否授权 Agent 在 HTTP 心跳握手成功后升级建立持久 WebSocket 实时连接true
node_offline_thresholdint在管理后台中判定节点失去心跳并标注为离线状态的无响应阈值(毫秒)60000 (60s)
agent_update_repostringAgent 节点更新下载自身二进制的 Release 仓库源Rain-kl/OpenFlare
geoip_providerstringGeoIP 提供商,支持 maxmind 等,用于 WAF 防护时地域分析ipinfo

5. Uptime Kuma 监控联动同步

配置键 (Key)数据类型作用说明默认值
uptime_kuma_enabledbool是否自动同步站点并生成 Uptime Kuma 对应的 HTTP 监控项false
uptime_kuma_urlstringUptime Kuma 控制端实例的访问 URL (含端口与路径)空
uptime_kuma_usernamestringUptime Kuma 后台用于同步接口调用认证的管理员账号名称空
uptime_kuma_passwordstringUptime Kuma 后台对应的登录密码(后台写入后加密隐藏,不可回显)空
uptime_kuma_monitor_scopestring自动生成监控项的路由范围(支持 all 全选网站或 selected 选定部分)all
uptime_kuma_selected_sitesstring选定进行监控的代理网站 Site Name 名称列表(英文逗号分隔)空
uptime_kuma_sync_intervalint向 Uptime Kuma 实例进行差异扫描并校准同步的频率间隔(分钟)5
uptime_kuma_intervalint生成的 HTTP 监控对象发出 HTTP GET 探测的周期检测频率(秒)60
uptime_kuma_retryintHTTP 监控对象在遭遇连接波动失败后的最大重试重连次数0
uptime_kuma_retry_intervalintHTTP 监控对象失败重连重试的间隔停顿时间(秒)60
uptime_kuma_timeoutint触发 HTTP GET 监控请求判定超时的断开限制时间(秒)48

6. 边缘网关安全与限流参数 (Edge Security & Rate Limits)

OpenFlare 边缘网关已全面采用 Pingora 架构,原 OpenResty / Nginx 底层配置参数(如 worker_processes, worker_connections, worker_rlimit_nofile, keepalive_timeout 等)已彻底废弃并从系统配置中移除。边缘运行参数、回源连接池、HTTP/2、TLS 监听及反向代理缓存等策略已移至控制台「性能策略」模块进行可视化管理并向边缘节点统一下发(详见 Pingora 性能策略)。

系统运行时保留通用的边缘网关安全防护与限流参数(edge_*),管理员可在后台「系统管理 → 系统配置 → 业务配置」中调整:

配置键 (Key)数据类型作用说明默认值
edge_trusted_proxy_cidrsstring (JSON 数组)可读取 CF-Connecting-IP 的可信代理 IPv4/IPv6 CIDR 列表;默认包含 Cloudflare 官方 22 个 IPv4/IPv6 网段;显式 [] 会关闭自动生成的可信代理配置Cloudflare 官方网段
edge_default_limit_conn_per_serverint站点未单独配置时的默认服务级并发连接上限;0 表示默认关闭0
edge_default_limit_conn_per_ipint站点未单独配置时的默认单 IP 并发连接上限;0 表示默认关闭0
edge_default_limit_ratestring站点未单独配置时的默认单请求带宽限制(如 512k);空表示默认关闭空
edge_default_limit_req_per_ipstring站点未单独配置时的默认单 IP 请求频率限制(如 10r/s、100r/m);空表示默认关闭空

在管理端「系统管理 → 系统配置 → 业务配置」中编辑 edge_trusted_proxy_cidrs。默认值为 Cloudflare 官方完整 22 个 IPv4/IPv6 网段,可从 Cloudflare IPv4 网段 和 IPv6 网段 核对并按官方更新维护。若要信任额外内网代理,应将其 CIDR 追加到现有数组;例如 10.2.0.227 只有在确认它是可信代理、且它发送的 CF-Connecting-IP 真实可靠后,才追加 10.2.0.227/32。该地址不属于默认信任范围。显式设置为 [] 会关闭由此配置生成的转发头信任;已有显式空值不会在升级时自动改为默认。保存后自动同步到边缘节点。Pingora 对来自可信网段的请求读取 CF-Connecting-IP,访问日志、WAF 和上游 X-Real-IP 使用恢复后的客户端地址。缺少该配置值时使用 Cloudflare 默认网段,非法 JSON 按空列表处理。

7. 源站错误页 (Origin Error Page)

全局源站错误页保存后随站点快照自动同步到边缘节点。仅作用于反向代理路由;Pages 静态路由不受影响。管理端入口:「网站管理 → 错误页」。设计说明见 源站错误页设计。

配置键 (Key)数据类型作用说明默认值
origin_error_page_enabledbool是否启用全局源站错误页。开启后,源站或网关返回的匹配状态码由自定义/默认 HTML 替换,HTTP 状态码保持原值;关闭后恢复透传。保存后自动同步true
origin_error_page_get_onlybool是否仅对 GET 请求生效。开启后仅 GET 的匹配错误状态码返回自定义错误页;POST/PUT 等其它方法透传源站响应(原始状态码与响应体不变)false
origin_error_page_status_codesjson触发错误页的状态码标签 JSON 数组。支持单码(如 522)与闭区间(如 500-599);单码与区间两端均须在 400–599,且 lo ≤ hi。启用时展开结果不能为空["500-599"]
origin_error_page_htmlstring错误页自定义 HTML。空字符串表示使用内置 OpenFlare 默认模板(极简白底);支持占位符 {{status}}(与 HTTP 状态码一致)、{{host}}(请求 Host)。最大 256 KiB(按字节)。勿嵌入不可信第三方脚本空

8. 日志存储(Log Database)

日志存储解耦后的运行时配置:日志主库由「切换日志数据库」任务管理(内部/受保护 key,禁止管理员手动修改),访问日志保留天数按存储库分别在业务配置中设置;性能指标(CPU/内存/磁盘/网络)价值衰减快,按三库共用的独立短留存清理。

配置键 (Key)数据类型作用说明默认值
log_databasestring当前日志主库(postgres / sqlite / clickhouse)。内部受保护 key:仅「切换日志数据库」迁移任务写入,管理员不可手动创建/修改随主库(PostgreSQL 启用时为 postgres,否则 sqlite;ClickHouse 启用时优先 clickhouse)
log_db_migrationstring日志迁移冻结标记(migrating 或空)。内部受保护 key:仅迁移任务写入,置位期间日志写入返回 503「日志数据库迁移中,暂不可写」空
log_retention_days_postgresintPostgreSQL 日志库的访问日志过期清理保留天数(过期日志由系统垃圾清理每日任务删除)30
log_retention_days_sqliteintSQLite 日志库的访问日志过期清理保留天数30
log_retention_days_clickhouseintClickHouse 日志库的访问日志过期清理保留天数30
metric_retention_daysint性能指标(CPU/内存/磁盘/网络)保留天数,三库共用独立短留存(不随访问日志保留配置)3

前端构建环境变量

环境变量作用默认值
WAVELET_BACKEND_URL服务端渲染与开发代理访问的后端地址http://localhost:3000
NEXT_PUBLIC_WAVELET_BACKEND_URL浏览器端请求 API 的后端地址;为空时使用同源空
NEXT_PUBLIC_APP_VERSION前端展示版本号dev

Pingora Edge 启动参数

openflare-edge run 使用 --server-url、--token-type discovery|node、--token-file 和 --state-dir 连接控制端。监听地址由 --http-listen 和可选的 --tls-listen 设置。由安装脚本管理的服务默认监听 80 和 443,状态目录为 /var/lib/openflare-edge。升级现有节点配置时附加 --upgrade。


Relay 环境变量与配置字段

环境变量

  • LOG_LEVEL:Relay 日志等级,默认 info。
  • 支持 OPENFLARE_SERVER_URL、OPENFLARE_AGENT_TOKEN、OPENFLARE_DISCOVERY_TOKEN、OPENFLARE_NODE_NAME、OPENFLARE_NODE_IP、OPENFLARE_DATA_DIR、OPENFLARE_FRPS_PATH 环境变量覆盖。

命令行参数

  • -config:指定 Relay 配置文件路径,默认 ./relay.json。

配置文件字段 (relay.json)

字段作用是否必填默认值/行为
server_url控制面地址是无
agent_token中继节点专属认证 Token与 discovery_token 二选一空
discovery_token首次自动注册使用的全局 Token与 agent_token 二选一空
node_name节点名称否自动使用主机名
node_ip中继节点 IP,用于接收穿透流量否自动探测,优先使用公网出口 IP;失败时退回网卡探测
frps_pathfrps 二进制路径否frps(在系统 PATH 中寻找)
data_dirRelay 运行时数据目录否配置文件所在目录下的 data
state_pathRelay 本地状态文件存储路径(运行时自动生成)否<data_dir>/relay-state.json
heartbeat_interval心跳间隔否10000 毫秒
request_timeoutHTTP 请求超时否10000 毫秒

OpenFlared (Client) 环境变量与配置字段

环境变量

  • LOG_LEVEL:Client 日志等级,默认 info。
  • 支持 OPENFLARE_SERVER_URL、OPENFLARE_TUNNEL_TOKEN、OPENFLARE_DATA_DIR、OPENFLARE_FRPC_PATH 环境变量覆盖。

命令行参数

  • -config:指定 Client 配置文件路径,默认 ./flared.json。

配置文件字段 (flared.json)

字段作用是否必填默认值/行为
server_url控制面地址是无
tunnel_token隧道专属认证 Token是无
frpc_pathfrpc 二进制路径否frpc(在系统 PATH 中寻找)
data_dirClient 运行时数据目录否配置文件所在目录下的 data
state_pathClient 本地状态文件存储路径(运行时自动生成)否<data_dir>/flared-state.json
heartbeat_interval心跳间隔否10000 毫秒
sync_interval配置拉取同步间隔否30000 毫秒
request_timeoutHTTP 请求超时否10000 毫秒

本页目录