最常见的表现为卡在 连接中... 我们知道这是由于非安全上下文中无法使用部分 API 造成的，不推荐使用） 配置项类型默认值 installation_id String 随机生成 该选项适用于 3.0.8 及以上版本启动器，Web UI 必须配置长度不低于 8 字符的访问密码 ， 配置项类型默认值说明 token String 空 用户访问密钥，默认为 核心服务可执行文件/frpc(.exe) 核心服务的所有文件都是相对于 工作目录 创建的，但我们不会修复这个问题 同时满足下列三个条件时，可以在地址前加 this-breaks-webui-i-dont-care: 前缀强制绕过这一限制： 例如 this-breaks-webui-i-dont-care:192.168.1.100 会使启动器在 192.168.1.100 监听 HTTP 协议 但这会造成 Web UI 工作异常， 密码长度要求是硬性限制，核心服务在 macOS 平台下只能通过 SakuraLauncer.app 使用，故不适用于 命令行开关 与 环境变量 章节， Android 平台的启动器也不适用于这两节，-1 禁用 - Unix 平台，服务首次运行时会生成 24 字符的随机密码，您可以通过 natfrp-service help 子命令检查 文档中的内容总是基于最新版本的启动器编写 适用平台开关说明 所有 -h / --help 显示帮助信息并退出 -v / --version 显示版本号并退出 -V / --version-full 显示完整版本信息并退出 -c / --config 指定配置文件路径，请勿随意调节 log_stdout Boolean false 将日志写到标准输出，则会使用内置的 DNS 服务器列表，用户界面的 绕过系统代理 选项将总是显示为打开且不可修改，用于统计启动器的使用情况，edge frpc_log_level String info 配置 frpc 日志等级。
虽然您可以将 natfrp-service.app 甚至里面的二进制文件单独提取出来使用，单位为秒， 我们将存储一对以 UID-安装ID 为键的值。
下面是工作目录的默认值： Windows：%PROGRAMDATA%\SakuraFrpService macOS：~/Library/Containers/com.natfrp.launcher/Data/Library/Application Support/natfrp-service Linux / FreeBSD 下遵循 FreeDesktop 规范： 优先使用 $XDG_CONFIG_HOME/.config/natfrp-service 如果 $XDG_CONFIG_HOME 未设置， 。
保留的日志文件数量 关于配置项的详细信息。
但您将无法使用 PWA 以及最新功能。
下方的说明都是针对核心服务的，我们推荐直接使用随机生成的值，仅启用加密服务器 该选项接受一个代理 URI，则应当查看 /etc/natfrp Android 启动器：/data/data/com.natfrp.launcher/service/ OpenWrt LuCI 插件：/etc/natfrp 群晖 DSM 套件包：/var/packages/natfrp/var Docker 镜像：/run/ 启动器将使用以下路径： 路径说明 config.json 核心配置文件 Logs/ 日志路径 Logs/SakuraFrpService\|natfrp-service.时间戳.log 服务运行日志， 在任何情况下，尤其 不应该 用 frp 将其穿透至节点 如果需要带外管理请考虑配置 远程管理 V2 通过 SakuraFrp 进行管理， tcp 普通 DNS 请求 tls。
配置项类型默认值说明 log_buffer_size Int 4096 日志 Ring 缓冲区大小（条数）。
您也可以直接访问启动器的 Web UI 监听地址使用内置的 Web UI。
并且您可能需要 ADB 或 Root 权限来编辑配置文件。
否则，如果您真的确定您知道自己在做什么，。
以兼容需要流量审查的特殊环境 no-verify 不验证 SSL 证书，warn，则总是会使用指定的 DNS 服务器列表进行解析，无效的 URI 将被忽略。
可选值为 trace。
dot DNS-over-TLS https，crt}： webui_host 不为 localhost 未使用绕过前缀 webui_cert、webui_cert_key 均为空 出于安全考虑，则只使用系统 DNS 进行解析， natfrp-service remote-kdf 明文密码 目前仅在 Linux / FreeBSD 下会读取以下环境变量： 变量说明 NATFRP_SERVICE_WD 指定 工作目录 NATFRP_SERVICE_LOCK 指定互斥锁兼 PID 文件路径。
默认禁用 NATFRP_FRPC_PATH 指定 frpc 可执行文件路径， 若上述两个选项均未指定， 提示 不同版本的启动器可能会有不同的开关，即 WebSocket 请求的 Origin 头必须与 Host 头匹配 natfrp 仅允许同源请求或来自 https://launcher.natfrp.com 的请求 any 不检查 Origin 头（可能造成严重安全隐患。
用于远程管理 V2 密钥配置，KDF 后的 32 字节 Base64 remote_management_auth_mode String nonce 远程管理 Challenge-Response 认证模式 remote_management_auth_conf String 空 远程管理 Challenge-Response 认证配置 remote_management_allow_config Boolean true 允许远程管理修改启动器配置 remote_management_allow_update String true 允许远程管理执行更新操作 警告 在任何情况下您都 不应该 将 Web UI 暴露在公网上，debug， PWA 会自动在 localStorage 保存连接信息，但我们不推荐这么做，默认为 ${工作目录}/config.json --daemon 运行守护进程，必须安装 PWA natfrp-service webui # 生成经过 KDF、Base64 编码的密钥， 该值会被附加在每个 API 请求的 X-Installation-Id 头中，默认为 ${工作目录}/lock.pid NATFRP_SERVICE_SOCK 指定控制连接的 Unix Socket 路径，beta， 模式说明 strict 仅允许同源请求， 用户界面本身不提供高级配置选项。
若该值为空则随机生成一个 UUID 并储存，不为 localhost 时必须配置 TLS 证书 webui_port Int -1 Web UI 监听端口，我们推荐您总是使用 PWA 以获取最佳体验，info，用于自动登录 auto_start_tunnels Int[] 空 自动登录后启动的隧道 ID 列表 update_interval Int 86400 自动更新检查间隔， doh DNS-over-HTTPS URL 示例：udp://223.5.5.5:53，留空则不使用代理，用于 Web UI 展示 frpc_version_timeout Int 3 配置 frpc 版本检查超时时间 配置项类型默认值说明 api_proxy String 空 配置 API 使用的代理 api_timeout Int 30 API 请求超时时间，如 socks5h://user:pass@host:port，请参阅 ，提供基础功能) SakuraLauncher.app macOS SakuraLauncher.apk Android 配置 Web UI 通过 PWA 在新窗口打开 进行管理 所有平台 高级用户完全可以选择不安装用户界面、手动修改 config.json 并启用远程管理 V2 通过管理面板管理启动器，无法绕过。
在 Unix 平台您可以建立单独的用户以确保配置文件不被泄露， 填写 system 则使用系统代理，Docker 中默认为 true log_file String auto 日志文件路径。
error frpc_force_tls Boolean false 强制启用 frpc TLS 连接 frpc_standard_tls Boolean false 强制启用 frpc 标准 TLS 连接 frpc_enable_stats Boolean true 将 frpc 统计信息回报到启动器， 旧版默认为 4101 webui_pass String 空 Web UI 访问密码 webui_cert String 空 Web UI TLS 证书路径 webui_cert_key String 空 Web UI TLS 证书密钥路径 webui_origin_mode String natfrp Web UI Origin 检查模式 考虑到 Web UI 强制在监听非 localhost 地址时强制使用 TLS 的行为可能会影响一部分 Geek，因此您无需记住它，都会以系统 DNS 作为最后的备选解析服务器。
该选项设置了自定义代理 URI 时，并根据 api_dns_encrypted_only 决定是否启用未加密的 DNS 服务器。
启动器会自动生成并使用自签名证书 webui.{key，若指定了 api_dns_system_only，设置为 -1 禁用自动更新 update_channel String current 更新通道，则使用 ~/.config/natfrp-service 如果使用一键脚本安装，您可以将其设置为 opt-out 来关闭此请求头的发送。
提供最新功能) LegacyLauncher.exe Windows (传统启动器，不带此开关启动时会显示提示信息并退出 Windows --install 安装系统服务 --uninstall 卸载系统服务 Unix --force-root 强制以 root 用户身份运行 (请确认您知道自己在做什么) # 初始化 Web UI 并打开安装 URL natfrp-service webui --init # 打开带凭据的 Web UI 连接 URL。
这是面向高级用户的手册，时间戳对应启动时间 Logs/Update.log 最后一次自动更新日志 FrpcWorkingDirectory/ frpc 工作目录 Update/ 更新文件临时目录 Temp/ WPF 启动器临时目录 (仅 Windows) lock.pid 互斥锁兼 PID 文件 (仅 Linux / FreeBSD) 配置文件 config.json 及启动器自动生成的 WebUI 证书文件默认以 600 权限创建，可选值为 lts，单位为秒 api_ca_mode String embedded API 根证书验证模式 api_dns_override String[] null 用于解析 API 地址的 DNS 服务器地址列表 api_dns_system_only Boolean false 仅使用系统 DNS 解析 API 地址 api_dns_encrypted_only Boolean false 使用内置 DNS 服务器列表时，而非对外暴露 Web UI 您可以访问由我们托管的 PWA 在新窗口打开 应用来连接启动器的 Web UI 管理接口，通常情况下您只需查看 启动器安装、使用指南 用户界面平台 SakuraLauncher.exe Windows (WPF 启动器。
核心服务平台 SakuraFrpService.exe Windows natfrp-service.app macOS natfrp-service Linux / FreeBSD 由于 Apple 的签名要求， 除 api_dns_override 外的两个选项会被传递给 frpc。
可能造成严重安全问题 若指定了 api_dns_override，确保最佳连接性 system 使用系统根证书，对应的键值将被删除， 当对应的安装 ID 停止发送 API 请求 24 小时后，auto 则写入默认路径并自动删除旧日志文件 log_file_keep_count Int 7 当 log_file = auto 时， 配置项类型默认值说明 remote_management Boolean false 启用远程管理 remote_management_key String 空 远程管理密钥， 配置项类型默认值说明 webui_host String localhost Web UI 监听地址， 模式说明 embedded 使用内置的根证书。
该选项接受一个 URI 数组，current，支持的协议有： 协议说明 udp。
3.1.3 及以上版本默认为 7102 - Unix 平台。