frp 如何把 INI 配置遷移到 TOML、YAML 或 JSON 格式【免費(fèi)下載鏈接】frpA fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fr/frpfrp 從 v0.52.0 起支持 TOML、YAML 和 JSON 三種配置格式INI 配置已被標(biāo)記為棄用deprecated并計(jì)劃在未來(lái)版本中移除新特性也只會(huì)出現(xiàn)在新格式中。如果你手里的 frpc 或 frps 還在用frpc.ini這類(lèi) INI 配置文件目標(biāo)就是把它們改寫(xiě)成 TOML或 YAML、JSON讓進(jìn)程按新格式解析啟動(dòng)不再輸出 INI 棄用警告。為什么遷移后文件會(huì)被識(shí)別成哪種格式frp 的配置加載邏輯在 pkg/config/load.go 中遷移前先弄清它的判斷規(guī)則否則會(huì)踩坑先看內(nèi)容不看擴(kuò)展名。只要文件內(nèi)容能按 INI 解析、且包含[common]段就被判定為 legacy INI 格式DetectLegacyINIFormat。也就是說(shuō)把frpc.ini直接改名為frpc.toml而內(nèi)容不改frp 仍然按 INI 解析還會(huì)繼續(xù)打印警告。非 INI 內(nèi)容會(huì)依次按 TOML → JSON → YAML 解析文件擴(kuò)展名.toml、.yaml/.yml、.json只用來(lái)提供更準(zhǔn)確的報(bào)錯(cuò)行號(hào)提示detectFormatFromPath。因此遷移的正確動(dòng)作是改寫(xiě)配置內(nèi)容本身并把文件保存為對(duì)應(yīng)擴(kuò)展名。遷移前提一個(gè)現(xiàn)有的 frpc 或 frps INI 配置文件例如倉(cāng)庫(kù)中的完整示例 conf/legacy/frpc_legacy_full.ini 和 conf/legacy/frps_legacy_full.ini。對(duì)照目標(biāo)格式倉(cāng)庫(kù)提供了可直接參考的新格式文件conf/frpc_full_example.toml、conf/frps_full_example.toml以及最小示例 conf/frpc.toml、conf/frps.toml。注意完整示例文件開(kāi)頭注明了 This configuration file is for reference only不要直接拿它運(yùn)行。棄用狀態(tài)可查 doc/deprecations.mdINI 格式的 Replacement 明確為 YAML / JSON / TOML移除時(shí)間Removal target為 TBD。INI 和新格式的字段名不同INI 用蛇形命名server_addr新格式用駝峰或帶點(diǎn)分組serverAddr、transport.poolCount。下面以客戶(hù)端為例給出主要映射。frpc 客戶(hù)端字段映射INI → TOML/YAML/JSON以下對(duì)照來(lái)自 conf/legacy/frpc_legacy_full.ini 與 conf/frpc_full_example.toml 兩個(gè)官方示例文件INI[common]段TOML/YAML/JSONserver_addrserverAddrserver_portserverPortuseruserlog_filelog.tolog_levellog.levellog_max_dayslog.maxDaystokenauth.token配auth.method tokenoidc_*auth.oidc.*admin_addr/admin_port/admin_user/admin_pwdwebServer.addr/webServer.port/webServer.user/webServer.passwordpprof_enablewebServer.pprofEnabledial_server_timeouttransport.dialServerTimeoutpool_counttransport.poolCounttcp_mux/tcp_mux_keepalive_intervaltransport.tcpMux/transport.tcpMuxKeepaliveIntervalprotocoltransport.protocolhttp_proxytransport.proxyURLconnect_server_local_iptransport.connectServerLocalIPquic_*transport.quic.*tls_enabletransport.tls.enabletls_cert_file/tls_key_file/tls_trusted_ca_file/tls_server_nametransport.tls.certFile/keyFile/trustedCaFile/serverNamedisable_custom_tls_first_bytetransport.tls.disableCustomTLSFirstByteheartbeat_interval/heartbeat_timeouttransport.heartbeatInterval/transport.heartbeatTimeoutudp_packet_sizeudpPacketSizemeta_var1metadatas.var1includesincludes新格式中是數(shù)組如[./confd/*.toml]代理段INI 中形如[ssh]的段在新格式中統(tǒng)一為[[proxies]]數(shù)組項(xiàng)段名變成name字段常用字段對(duì)照INI代理段內(nèi)TOML/YAML/JSON段名[ssh]name sshtypetypelocal_ip/local_port/remote_portlocalIP/localPort/remotePortbandwidth_limit/bandwidth_limit_modetransport.bandwidthLimit/transport.bandwidthLimitModeuse_encryption/use_compressiontransport.useEncryption/transport.useCompressiongroup/group_keyloadBalancer.group/loadBalancer.groupKeyhealth_check_type/health_check_interval_s/health_check_max_failed/health_check_timeout_shealthCheck.type/intervalSeconds/maxFailed/timeoutSecondshealth_check_urlhttp 健康檢查路徑healthCheck.pathsubdomain/custom_domainssubdomain/customDomains數(shù)組locationslocations數(shù)組http_user/http_pwdhttpUser/httpPasswordheader_X-From-WhererequestHeaders.set.x-from-wherehost_header_rewritehostHeaderRewriteproxy_protocol_versiontransport.proxyProtocolVersionmeta_var1metadatas.var1plugin xxxplugin_xxx yyy[proxies.plugin]表type xxx插件參數(shù)直接平鋪完整的字段包括 visitor、stcp/xtcp/sudp、端口范圍段等逐個(gè)對(duì)照 conf/frpc_full_example.toml 的注釋即可它和 conf/legacy/frpc_legacy_full.ini 是同一份配置在新舊兩種格式下的版本。改寫(xiě)一個(gè)最小 frpc 配置以倉(cāng)庫(kù)最小示例 conf/frpc.toml 對(duì)應(yīng)的 INI 寫(xiě)法server_addr/server_port 一個(gè)[test-tcp]代理段為例TOML 結(jié)果為serverAddr 127.0.0.1 serverPort 7000 [[proxies]] name test-tcp type tcp localIP 127.0.0.1 localPort 22 remotePort 6000把同樣的字段寫(xiě)成 YAML 或 JSON 時(shí)字段名完全一致只換語(yǔ)法。以下兩段是由上面 TOML 等價(jià)改寫(xiě)出的示例serverAddr: 127.0.0.1 serverPort: 7000 proxies: - name: test-tcp type: tcp localIP: 127.0.0.1 localPort: 22 remotePort: 6000{ serverAddr: 127.0.0.1, serverPort: 7000, proxies: [ { name: test-tcp, type: tcp, localIP: 127.0.0.1, localPort: 22, remotePort: 6000 } ] }三種格式任選其一把文件分別保存為frpc.toml、frpc.yaml或frpc.json即可。frps 服務(wù)端遷移服務(wù)端的映射規(guī)則與客戶(hù)端一致蛇形改駝峰/點(diǎn)分組。最小服務(wù)端配置對(duì)應(yīng) conf/frps.tomlbindPort 7000其余字段kcpBindPort、quicBindPort、vhostHTTPPort、vhostHTTPSPort、webServer.*、transport.*等逐行對(duì)照 conf/frps_full_example.toml 與 conf/legacy/frps_legacy_full.ini 完成替換。啟動(dòng)并驗(yàn)證遷移結(jié)果遷移后用新文件啟動(dòng)frpc 的-c參數(shù)默認(rèn)值是./frpc.ini所以要顯式傳入新路徑./frps -c ./frps.toml ./frpc -c ./frpc.toml驗(yàn)證有三條依據(jù)均來(lái)自動(dòng)態(tài)加載與啟動(dòng)代碼INI 警告消失。使用 legacy INI 啟動(dòng)時(shí)frpc 和 frps 都會(huì)打印固定警告見(jiàn) cmd/frpc/sub/root.go 與 cmd/frps/root.goWARNING: ini format is deprecated and the support will be removed in the future, please use yaml/json/toml format instead!換成新格式后這條警告不再出現(xiàn)如果還在出現(xiàn)說(shuō)明內(nèi)容仍含[common]段被判定成了 INI。正常啟動(dòng)日志。frps 啟動(dòng)成功后輸出frps started successfullyfrpc 輸出start frpc service for config file [xxx] with aggregated configuration隨后按配置建立到服務(wù)端的連接。嚴(yán)格模式幫你抓錯(cuò)別字。frpc 和 frps 的--strict_config參數(shù)默認(rèn)都是 true未知字段會(huì)直接報(bào)錯(cuò)而不是靜默忽略。這正適合遷移場(chǎng)景映射表里寫(xiě)錯(cuò)的字段名會(huì)在啟動(dòng)時(shí)立刻暴露出來(lái)。限制與注意事項(xiàng)新格式不支持 INI 的includes用*.ini擴(kuò)展引用舊文件新格式的includes加載的是 TOML/YAML/JSON 文件見(jiàn) pkg/config/load.go 中LoadAdditionalClientConfigs的注釋 support yaml/json/toml配套引用的配置文件也要一并轉(zhuǎn)換。INI 的移除時(shí)間目前是 TBD不是隨下一個(gè)版本刪除但既然新特性只加在新格式上建議盡早遷移。配置模板渲染環(huán)境變量替換、parseNumberRange等對(duì)非 INI 格式同樣生效這部分行為不變。字段拿不準(zhǔn)時(shí)把 conf/legacy/frpc_legacy_full.ini 與 conf/frpc_full_example.toml 并排看一遍兩個(gè)文件覆蓋同一套完整配置逐段對(duì)照就能補(bǔ)全上表沒(méi)列到的項(xiàng)?！久赓M(fèi)下載鏈接】frpA fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/fr/frp創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考