frp 如何把 INI 配置遷移到 TOML、YAML 或 JSON 格式【免費下載鏈接】frpA fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.項目地址: https://gitcode.com/GitHub_Trending/fr/frpfrp 從 v0.52.0 起支持 TOML、YAML 和 JSON 三種配置格式INI 配置已被標記為棄用deprecated并計劃在未來版本中移除新特性也只會出現(xiàn)在新格式中。如果你手里的 frpc 或 frps 還在用frpc.ini這類 INI 配置文件目標就是把它們改寫成 TOML或 YAML、JSON讓進程按新格式解析啟動不再輸出 INI 棄用警告。為什么遷移后文件會被識別成哪種格式frp 的配置加載邏輯在 pkg/config/load.go 中遷移前先弄清它的判斷規(guī)則否則會踩坑先看內(nèi)容不看擴展名。只要文件內(nèi)容能按 INI 解析、且包含[common]段就被判定為 legacy INI 格式DetectLegacyINIFormat。也就是說把frpc.ini直接改名為frpc.toml而內(nèi)容不改frp 仍然按 INI 解析還會繼續(xù)打印警告。非 INI 內(nèi)容會依次按 TOML → JSON → YAML 解析文件擴展名.toml、.yaml/.yml、.json只用來提供更準確的報錯行號提示detectFormatFromPath。因此遷移的正確動作是改寫配置內(nèi)容本身并把文件保存為對應擴展名。遷移前提一個現(xiàn)有的 frpc 或 frps INI 配置文件例如倉庫中的完整示例 conf/legacy/frpc_legacy_full.ini 和 conf/legacy/frps_legacy_full.ini。對照目標格式倉庫提供了可直接參考的新格式文件conf/frpc_full_example.toml、conf/frps_full_example.toml以及最小示例 conf/frpc.toml、conf/frps.toml。注意完整示例文件開頭注明了 This configuration file is for reference only不要直接拿它運行。棄用狀態(tài)可查 doc/deprecations.mdINI 格式的 Replacement 明確為 YAML / JSON / TOML移除時間Removal target為 TBD。INI 和新格式的字段名不同INI 用蛇形命名server_addr新格式用駝峰或帶點分組serverAddr、transport.poolCount。下面以客戶端為例給出主要映射。frpc 客戶端字段映射INI → TOML/YAML/JSON以下對照來自 conf/legacy/frpc_legacy_full.ini 與 conf/frpc_full_example.toml 兩個官方示例文件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ù)組項段名變成name字段常用字段對照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、端口范圍段等逐個對照 conf/frpc_full_example.toml 的注釋即可它和 conf/legacy/frpc_legacy_full.ini 是同一份配置在新舊兩種格式下的版本。改寫一個最小 frpc 配置以倉庫最小示例 conf/frpc.toml 對應的 INI 寫法server_addr/server_port 一個[test-tcp]代理段為例TOML 結果為serverAddr 127.0.0.1 serverPort 7000 [[proxies]] name test-tcp type tcp localIP 127.0.0.1 localPort 22 remotePort 6000把同樣的字段寫成 YAML 或 JSON 時字段名完全一致只換語法。以下兩段是由上面 TOML 等價改寫出的示例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 服務端遷移服務端的映射規(guī)則與客戶端一致蛇形改駝峰/點分組。最小服務端配置對應 conf/frps.tomlbindPort 7000其余字段kcpBindPort、quicBindPort、vhostHTTPPort、vhostHTTPSPort、webServer.*、transport.*等逐行對照 conf/frps_full_example.toml 與 conf/legacy/frps_legacy_full.ini 完成替換。啟動并驗證遷移結果遷移后用新文件啟動frpc 的-c參數(shù)默認值是./frpc.ini所以要顯式傳入新路徑./frps -c ./frps.toml ./frpc -c ./frpc.toml驗證有三條依據(jù)均來自動態(tài)加載與啟動代碼INI 警告消失。使用 legacy INI 啟動時frpc 和 frps 都會打印固定警告見 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)說明內(nèi)容仍含[common]段被判定成了 INI。正常啟動日志。frps 啟動成功后輸出frps started successfullyfrpc 輸出start frpc service for config file [xxx] with aggregated configuration隨后按配置建立到服務端的連接。嚴格模式幫你抓錯別字。frpc 和 frps 的--strict_config參數(shù)默認都是 true未知字段會直接報錯而不是靜默忽略。這正適合遷移場景映射表里寫錯的字段名會在啟動時立刻暴露出來。限制與注意事項新格式不支持 INI 的includes用*.ini擴展引用舊文件新格式的includes加載的是 TOML/YAML/JSON 文件見 pkg/config/load.go 中LoadAdditionalClientConfigs的注釋 support yaml/json/toml配套引用的配置文件也要一并轉換。INI 的移除時間目前是 TBD不是隨下一個版本刪除但既然新特性只加在新格式上建議盡早遷移。配置模板渲染環(huán)境變量替換、parseNumberRange等對非 INI 格式同樣生效這部分行為不變。字段拿不準時把 conf/legacy/frpc_legacy_full.ini 與 conf/frpc_full_example.toml 并排看一遍兩個文件覆蓋同一套完整配置逐段對照就能補全上表沒列到的項?！久赓M下載鏈接】frpA fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.項目地址: https://gitcode.com/GitHub_Trending/fr/frp創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 frp 如何把 INI 配置遷移到 TOML、YAML 或 JSON 格式
frp 如何把 INI 配置遷移到 TOML、YAML 或 JSON 格式【免費下載鏈接】frpA fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.項目地址: https://gitcode.com/GitHub_Trending/fr/frpfrp 從 v0.52.0 起支持 TOML、YAML 和 JSON 三種配置格式INI 配置已被標記為棄用deprecated并計劃在未來版本中移除新特性也只會出現(xiàn)在新格式中。如果你手里的 frpc 或 frps 還在用frpc.ini這類 INI 配置文件目標就是把它們改寫成 TOML或 YAML、JSON讓進程按新格式解析啟動不再輸出 INI 棄用警告。為什么遷移后文件會被識別成哪種格式frp 的配置加載邏輯在 pkg/config/load.go 中遷移前先弄清它的判斷規(guī)則否則會踩坑先看內(nèi)容不看擴展名。只要文件內(nèi)容能按 INI 解析、且包含[common]段就被判定為 legacy INI 格式DetectLegacyINIFormat。也就是說把frpc.ini直接改名為frpc.toml而內(nèi)容不改frp 仍然按 INI 解析還會繼續(xù)打印警告。非 INI 內(nèi)容會依次按 TOML → JSON → YAML 解析文件擴展名.toml、.yaml/.yml、.json只用來提供更準確的報錯行號提示detectFormatFromPath。因此遷移的正確動作是改寫配置內(nèi)容本身并把文件保存為對應擴展名。遷移前提一個現(xiàn)有的 frpc 或 frps INI 配置文件例如倉庫中的完整示例 conf/legacy/frpc_legacy_full.ini 和 conf/legacy/frps_legacy_full.ini。對照目標格式倉庫提供了可直接參考的新格式文件conf/frpc_full_example.toml、conf/frps_full_example.toml以及最小示例 conf/frpc.toml、conf/frps.toml。注意完整示例文件開頭注明了 This configuration file is for reference only不要直接拿它運行。棄用狀態(tài)可查 doc/deprecations.mdINI 格式的 Replacement 明確為 YAML / JSON / TOML移除時間Removal target為 TBD。INI 和新格式的字段名不同INI 用蛇形命名server_addr新格式用駝峰或帶點分組serverAddr、transport.poolCount。下面以客戶端為例給出主要映射。frpc 客戶端字段映射INI → TOML/YAML/JSON以下對照來自 conf/legacy/frpc_legacy_full.ini 與 conf/frpc_full_example.toml 兩個官方示例文件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ù)組項段名變成name字段常用字段對照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、端口范圍段等逐個對照 conf/frpc_full_example.toml 的注釋即可它和 conf/legacy/frpc_legacy_full.ini 是同一份配置在新舊兩種格式下的版本。改寫一個最小 frpc 配置以倉庫最小示例 conf/frpc.toml 對應的 INI 寫法server_addr/server_port 一個[test-tcp]代理段為例TOML 結果為serverAddr 127.0.0.1 serverPort 7000 [[proxies]] name test-tcp type tcp localIP 127.0.0.1 localPort 22 remotePort 6000把同樣的字段寫成 YAML 或 JSON 時字段名完全一致只換語法。以下兩段是由上面 TOML 等價改寫出的示例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 服務端遷移服務端的映射規(guī)則與客戶端一致蛇形改駝峰/點分組。最小服務端配置對應 conf/frps.tomlbindPort 7000其余字段kcpBindPort、quicBindPort、vhostHTTPPort、vhostHTTPSPort、webServer.*、transport.*等逐行對照 conf/frps_full_example.toml 與 conf/legacy/frps_legacy_full.ini 完成替換。啟動并驗證遷移結果遷移后用新文件啟動frpc 的-c參數(shù)默認值是./frpc.ini所以要顯式傳入新路徑./frps -c ./frps.toml ./frpc -c ./frpc.toml驗證有三條依據(jù)均來自動態(tài)加載與啟動代碼INI 警告消失。使用 legacy INI 啟動時frpc 和 frps 都會打印固定警告見 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)說明內(nèi)容仍含[common]段被判定成了 INI。正常啟動日志。frps 啟動成功后輸出frps started successfullyfrpc 輸出start frpc service for config file [xxx] with aggregated configuration隨后按配置建立到服務端的連接。嚴格模式幫你抓錯別字。frpc 和 frps 的--strict_config參數(shù)默認都是 true未知字段會直接報錯而不是靜默忽略。這正適合遷移場景映射表里寫錯的字段名會在啟動時立刻暴露出來。限制與注意事項新格式不支持 INI 的includes用*.ini擴展引用舊文件新格式的includes加載的是 TOML/YAML/JSON 文件見 pkg/config/load.go 中LoadAdditionalClientConfigs的注釋 support yaml/json/toml配套引用的配置文件也要一并轉換。INI 的移除時間目前是 TBD不是隨下一個版本刪除但既然新特性只加在新格式上建議盡早遷移。配置模板渲染環(huán)境變量替換、parseNumberRange等對非 INI 格式同樣生效這部分行為不變。字段拿不準時把 conf/legacy/frpc_legacy_full.ini 與 conf/frpc_full_example.toml 并排看一遍兩個文件覆蓋同一套完整配置逐段對照就能補全上表沒列到的項?！久赓M下載鏈接】frpA fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.項目地址: https://gitcode.com/GitHub_Trending/fr/frp創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考