 diaspora* TOML 配置：100+個(gè)關(guān)鍵參數(shù)逐項(xiàng)拆解，新手也能秒懂)
如何玩轉(zhuǎn) diaspora* TOML 配置100個(gè)關(guān)鍵參數(shù)逐項(xiàng)拆解新手也能秒懂【免費(fèi)下載鏈接】diasporaA privacy-aware, distributed, open source social network.項(xiàng)目地址: https://gitcode.com/gh_mirrors/di/diasporadiaspora*A privacy-aware, distributed, open source social network是一個(gè)注重隱私、去中心化的開(kāi)源社交網(wǎng)絡(luò)。它的核心配置文件diaspora.toml集中了 URL、郵件、注冊(cè)開(kāi)關(guān)、隱私保護(hù)等 100 多個(gè)關(guān)鍵參數(shù)。本文用通俗語(yǔ)言逐項(xiàng)拆解這份 TOML 配置幫你快速掌握 diaspora* 的完整配置指南即使從未運(yùn)維過(guò)服務(wù)器也能看懂。一、先認(rèn)識(shí)配置文件diaspora.toml 長(zhǎng)什么樣diaspora* 啟動(dòng)時(shí)由 config/load_config.rb 加載配置它會(huì)按以下優(yōu)先級(jí)合并多個(gè)來(lái)源后者被前者覆蓋環(huán)境變量最高優(yōu)先級(jí)適合容器化部署config/diaspora.toml你自己編輯的主配置文件config/defaults.yml官方默認(rèn)值兜底 官方示例文件 config/diaspora.toml.example 是所有參數(shù)的總目錄部署時(shí)把它復(fù)制成diaspora.toml再按需修改即可。新手必懂的 3 條注釋規(guī)則文件開(kāi)頭的注釋## Some notes about this file說(shuō)明了三條鐵律規(guī)則說(shuō)明##開(kāi)頭是說(shuō)明文檔告訴你是干嘛的#開(kāi)頭是被注釋掉的配置項(xiàng)想啟用必須先去掉#引號(hào)true、false、數(shù)字不用引號(hào)其余URL、主機(jī)名等必須成對(duì)加引號(hào)也就是說(shuō)只刪掉#還不夠多數(shù)情況下還要把示例值改成你自己的值。用環(huán)境變量覆蓋配置不想改文件TOML 支持用環(huán)境變量覆蓋任意參數(shù)轉(zhuǎn)換規(guī)則為去掉頂層命名空間 → 把點(diǎn)換成下劃線 → 轉(zhuǎn)大寫(xiě)例如environment.s3.enable對(duì)應(yīng)環(huán)境變量ENVIRONMENT_S3_ENABLE列表則用逗號(hào)分隔。這對(duì) Heroku / Docker 部署尤其友好。二、[configuration.environment]Pod 能不能跑起來(lái)就看這一段這是官方標(biāo)注必須檢查的核心段。1.urlPod 的公網(wǎng)地址最重要url https://example.org/填瀏覽器訪問(wèn) Pod 用的地址用了反向代理就填代理的 URL??初始部署后不要改該地址會(huì)被硬編碼進(jìn)數(shù)據(jù)庫(kù)改成https除外忘了設(shè)置默認(rèn)值是http://localhost:3000/見(jiàn) config/defaults.yml2.certificate_authoritiesCA 證書(shū)包路徑生產(chǎn)環(huán)境必須指定否則 config/load_config.rb 會(huì)直接報(bào)錯(cuò)退出。常見(jiàn)取值Debian / Ubuntu / Arch/etc/ssl/certs/ca-certificates.crtCentOS / Fedora/etc/pki/tls/certs/ca-bundle.crt3.redis連接遠(yuǎn)程 Redis默認(rèn)是localhost。遠(yuǎn)程部署時(shí)寫(xiě)成redis://用戶名:密碼主機(jī):6379/0或 unix socket 形式務(wù)必先限制 IP 訪問(wèn)。4.require_ssl強(qiáng)制 HTTPS默認(rèn) true生產(chǎn)模式會(huì)強(qiáng)制 HTTPS。因?yàn)?OAuth2 和 API 依賴 SSL不建議關(guān)掉否則 API 可能無(wú)法工作。5.image_redirect_url圖片放到外部圖床填上如https://images.example.org后所有/uploads/images請(qǐng)求都會(huì)跳轉(zhuǎn)到外部圖片服務(wù)器適合把圖片流量從主服務(wù)器分流出去。三、[configuration.environment.sidekiq]后臺(tái)任務(wù)引擎的 5 個(gè)旋鈕diaspora* 的聯(lián)邦收發(fā)、郵件、照片處理都靠 Sidekiq 隊(duì)列config/sidekiq.yml 和這一段決定它的脾氣參數(shù)默認(rèn)值通俗解釋concurrency5每個(gè) Sidekiq 工作進(jìn)程的并行線程數(shù)。中型 Pod 可加到 25記得同步調(diào)大數(shù)據(jù)庫(kù)連接池retry10失敗任務(wù)重試次數(shù)設(shè)太高隊(duì)列會(huì)堆積設(shè) 0 關(guān)閉重試backtrace15失敗時(shí)保留多少行堆棧日志設(shè)為false可省 Redis 內(nèi)存dead_jobs_limit5000死信隊(duì)列保留多少條默認(rèn)值越大越占內(nèi)存dead_jobs_timeout3628800死信保留秒數(shù)默認(rèn) 6 周過(guò)期即永久丟失 想提速優(yōu)先調(diào)concurrency而不是加更多 Sidekiq 進(jìn)程。四、存儲(chǔ)與靜態(tài)資源s3 / assets[configuration.environment.s3]照片存到 Amazon S3默認(rèn)關(guān)閉。啟用后需填key、secret、bucket、region四項(xiàng)cache true默認(rèn)會(huì)給 S3 資源加一年期的max-age緩存頭加速加載、減少回源。[configuration.environment.assets]靜態(tài)資源三件套serve讓?xiě)?yīng)用服務(wù)器自己發(fā)靜態(tài)文件生產(chǎn)環(huán)境強(qiáng)烈建議交給 Nginx 等反向代理upload/host把編譯后的 assets 上傳到 S3 或指定 CDN 主機(jī)注意 host 結(jié)尾不要帶/五、[configuration.environment.logging]日志與排錯(cuò)開(kāi)關(guān)參數(shù)默認(rèn)值作用logrotate.enabletrue每天滾動(dòng)切分應(yīng)用日志logrotate.days7日志保留天數(shù)debug.sqlfalse打印每條 SQL 語(yǔ)句性能排查利器debug.federationfalse打印聯(lián)邦收發(fā)的全部 XML調(diào)試跨 Pod 通信必備注意開(kāi)發(fā)環(huán)境下debug.sql在 config/defaults.yml 中默認(rèn)是開(kāi)啟的生產(chǎn)環(huán)境請(qǐng)保持關(guān)閉。六、[configuration.server]控制 script/server 的行為這段決定 script/server 啟動(dòng)時(shí)的表現(xiàn)listen監(jiān)聽(tīng)地址開(kāi)發(fā)環(huán)境默認(rèn)tcp://127.0.0.1:3000生產(chǎn)默認(rèn)unix://tmp/diaspora.sock配合 Nginxrails_environment默認(rèn)development生產(chǎn)部署務(wù)必改成productionpid/stderr_log/stdout_log進(jìn)程與日志文件路徑web_timeout單請(qǐng)求超時(shí)秒數(shù)默認(rèn) 90?？枕憫?yīng)、大圖片上傳失敗就調(diào)大它sidekiq_workersSidekiq 進(jìn)程數(shù)默認(rèn) 1一般不用動(dòng)七、[configuration.privacy]隱私保護(hù)專區(qū)diaspora* 以隱私著稱這一段集中體現(xiàn)了它的價(jià)值觀。1.jquery_cdn默認(rèn) falsefalse時(shí) jQuery 由你的 Pod 自己提供用戶流量完全不經(jīng)過(guò)第三方 CDN——這就是隱私優(yōu)先的默認(rèn)姿態(tài)。2.piwik自托管流量統(tǒng)計(jì)填hostsite_id即可啟用 [Piwik](https://piwik.org 的替代品)——比 Google 分析更尊重用戶隱私。注意它和下面的 CSP 默認(rèn)策略沖突啟用后需調(diào)整 CSP。3.statistics上報(bào)多少統(tǒng)計(jì)給 /statistics 和 NodeInfoPod 默認(rèn)只公開(kāi)名稱、版本、是否開(kāi)放注冊(cè)u(píng)ser_counts、post_counts、comment_counts默認(rèn)全關(guān)。是否開(kāi)放本地用戶/帖子數(shù)統(tǒng)計(jì)由管理員根據(jù)隱私策略自行決定。4.camo用反向代理保護(hù)用戶 IPlib/diaspora/camo.rb 依賴這一段。啟用 Camo 后proxy_markdown_images代理 Markdown 里的外部圖片推薦避免混合內(nèi)容警告proxy_opengraph_thumbnails代理 Open Graph 縮略圖推薦proxy_remote_pod_images連別的 Pod 的頭像照片都代理——隱私最佳但會(huì)大幅增加你的服務(wù)器流量root/keyCamo 服務(wù)地址與共享密鑰?? 三個(gè)代理項(xiàng)都默認(rèn)false請(qǐng)確保 Camo 已部署成功再開(kāi)啟。八、[configuration.settings]運(yùn)營(yíng)你的 Pod 的 20 個(gè)開(kāi)關(guān)這是參數(shù)最多、也最貼近日常運(yùn)營(yíng)的一段?；A(chǔ)信息與注冊(cè)參數(shù)默認(rèn)值說(shuō)明pod_namediaspora*Pod 名稱顯示在頁(yè)頭等各處enable_registrationstrue注冊(cè)開(kāi)關(guān)設(shè)為 false 后只能憑邀請(qǐng)碼加入首個(gè)賬號(hào)注冊(cè)時(shí)它必須是 trueenable_local_posts_streamdisabled本地帖子流可見(jiàn)范圍disabled / admins / moderators / everyoneautofollow_on_jointrue新用戶是否自動(dòng)關(guān)注指定賬號(hào)autofollow_on_join_userhqpod.diaspora.software被自動(dòng)關(guān)注的官方新聞賬號(hào)主題與外觀default_color_theme未登錄或未選擇主題時(shí)的默認(rèn)配色可選值見(jiàn) config/color_themes.ymloriginal、original_white、dark、dark_green、magenta、egyptian_bluedefault_metastitle與description控制全站默認(rèn) meta 標(biāo)簽直接影響搜索引擎展示捐贈(zèng)按鈕可任選其一liberapay_usernameLiberapay 用戶名bitcoin_address比特幣地址paypal_donations小節(jié)enablecurrency再二選一填托管按鈕 ID 或非托管按鈕的加密密鑰邀請(qǐng)、歡迎語(yǔ)與社區(qū)聚光燈invitationsopen默認(rèn) true允許用戶互發(fā)邀請(qǐng)count默認(rèn) 25是每鏈接邀請(qǐng)數(shù)welcome_messageenabled開(kāi)啟后新用戶注冊(cè)會(huì)收到一條站內(nèi)信text中的%{username}會(huì)自動(dòng)替換為新用戶昵稱community_spotlight給帶 spotlight 角色的賬號(hào)做新手指引展示suggest_email可收集用戶推薦安全與訪問(wèn)控制captcha注冊(cè)驗(yàn)證碼enable默認(rèn) true還可調(diào)image_size、captcha_length最長(zhǎng) 12、image_style9 種風(fēng)格、distortionlow/medium/high/randomterms服務(wù)條款開(kāi)關(guān)。enable 必填的jurisdiction管轄法律地區(qū)不填則相關(guān)段落不顯示 可選的minimum_age年齡限制。官方提醒默認(rèn)條款未經(jīng)律師審查嚴(yán)謹(jǐn)場(chǎng)景請(qǐng)咨詢法律專業(yè)人士自定義模板放在app/views/terms/csp內(nèi)容安全策略頭默認(rèn)已啟用report_only改為 true 可先只上報(bào)不攔截report_uri指定上報(bào)地址。改過(guò)模板或加了自定義 JS 的 Pod 需謹(jǐn)慎username_blacklist在 config/defaults.yml 中預(yù)置了 admin、root、postmaster 等 14 個(gè)保留用戶名可在 TOML 中追加性能相關(guān)typhoeus_concurrency默認(rèn) 20與其他 Pod 并行 HTTP 請(qǐng)求上限調(diào)大會(huì)顯著推高 Sidekiq 內(nèi)存占用typhoeus_verbose默認(rèn) false聯(lián)調(diào)聯(lián)邦問(wèn)題的詳細(xì)輸出開(kāi)關(guān)archive_jobs_concurrency默認(rèn) 1并行導(dǎo)入/導(dǎo)出用戶數(shù)據(jù)的任務(wù)數(shù)大賬號(hào)遷移很吃內(nèi)存小服務(wù)器別動(dòng)它九、[configuration.settings.maintenance]自動(dòng)清理不活躍用戶默認(rèn)關(guān)閉。開(kāi)啟后after_days默認(rèn) 730 天無(wú)活動(dòng)即標(biāo)記先發(fā)預(yù)警郵件再過(guò)warn_days默認(rèn) 30 天自動(dòng)注銷limit_removals_to_per_day默認(rèn) 100限制每日清理隊(duì)列量防止誤傷潮。十、[configuration.map.mapbox]帖子地理位置地圖需要到 Mapbox 注冊(cè)獲取access_token然后設(shè)置enabled true與style如mapbox/streets-v11帖子上的位置信息就會(huì)渲染成地圖。十一、[configuration.mail]郵箱沒(méi)配好通知全白搭默認(rèn)enable false不開(kāi)則不發(fā)任何郵件。完整流程enable true、sender_address填發(fā)件人選methodsmtp或sendmailSMTP 分支host、port默認(rèn) 587、authenticationplain / login / cram_md5 / none、username、password、starttls_auto默認(rèn) true自簽名證書(shū)才把openssl_verify_mode設(shè)為nonesendmail 分支location指向 sendmail 可執(zhí)行文件默認(rèn)/usr/sbin/sendmail可加exim_fix十二、[configuration.admins]管理員聯(lián)系信息account通用管理員聯(lián)系賬號(hào)只填用戶名如podmin不是完整 IDpodmin_email管理員聯(lián)系郵箱注意這里不會(huì)把你設(shè)為管理員它只是postmaster 式的通用聯(lián)系方式。十三、高級(jí)技巧分環(huán)境覆蓋與配置查詢文件末尾的[production]、[development]等頂層段可以按環(huán)境覆蓋全局配置例如讓生產(chǎn)環(huán)境用不同的 Redis[production] environment.redis redis://production.example.org:6379想確認(rèn)某個(gè)參數(shù)當(dāng)前生效的值直接用倉(cāng)庫(kù)自帶的 script/get_config.rb./script/get_config.rb settings.pod_name它會(huì)把最終合并結(jié)果打印出來(lái)排查我到底改沒(méi)改生效非常有用。十四、給新手的 5 條上手清單 復(fù)制 config/diaspora.toml.example 為config/diaspora.toml只動(dòng)必須項(xiàng)url、certificate_authorities、rails_environment配好[configuration.mail]否則注冊(cè)確認(rèn)、密碼重置都會(huì)失靈想關(guān)公開(kāi)注冊(cè)enable_registrations false并保留邀請(qǐng)功能改完用./script/get_config.rb抽查關(guān)鍵項(xiàng)再重啟服務(wù)總結(jié)diaspora* 的 TOML 配置雖然參數(shù)多達(dá) 100但 90% 的日常運(yùn)營(yíng)只涉及前八節(jié)的核心開(kāi)關(guān)。記住defaults.yml 兜底、TOML 覆蓋、環(huán)境變量最高這條優(yōu)先級(jí)鏈你就能自信地駕馭任意一個(gè) diaspora* Pod。【免費(fèi)下載鏈接】diasporaA privacy-aware, distributed, open source social network.項(xiàng)目地址: https://gitcode.com/gh_mirrors/di/diaspora創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 如何玩轉(zhuǎn) diaspora* TOML 配置：100+個(gè)關(guān)鍵參數(shù)逐項(xiàng)拆解，新手也能秒懂
如何玩轉(zhuǎn) diaspora* TOML 配置100個(gè)關(guān)鍵參數(shù)逐項(xiàng)拆解新手也能秒懂【免費(fèi)下載鏈接】diasporaA privacy-aware, distributed, open source social network.項(xiàng)目地址: https://gitcode.com/gh_mirrors/di/diasporadiaspora*A privacy-aware, distributed, open source social network是一個(gè)注重隱私、去中心化的開(kāi)源社交網(wǎng)絡(luò)。它的核心配置文件diaspora.toml集中了 URL、郵件、注冊(cè)開(kāi)關(guān)、隱私保護(hù)等 100 多個(gè)關(guān)鍵參數(shù)。本文用通俗語(yǔ)言逐項(xiàng)拆解這份 TOML 配置幫你快速掌握 diaspora* 的完整配置指南即使從未運(yùn)維過(guò)服務(wù)器也能看懂。一、先認(rèn)識(shí)配置文件diaspora.toml 長(zhǎng)什么樣diaspora* 啟動(dòng)時(shí)由 config/load_config.rb 加載配置它會(huì)按以下優(yōu)先級(jí)合并多個(gè)來(lái)源后者被前者覆蓋環(huán)境變量最高優(yōu)先級(jí)適合容器化部署config/diaspora.toml你自己編輯的主配置文件config/defaults.yml官方默認(rèn)值兜底 官方示例文件 config/diaspora.toml.example 是所有參數(shù)的總目錄部署時(shí)把它復(fù)制成diaspora.toml再按需修改即可。新手必懂的 3 條注釋規(guī)則文件開(kāi)頭的注釋## Some notes about this file說(shuō)明了三條鐵律規(guī)則說(shuō)明##開(kāi)頭是說(shuō)明文檔告訴你是干嘛的#開(kāi)頭是被注釋掉的配置項(xiàng)想啟用必須先去掉#引號(hào)true、false、數(shù)字不用引號(hào)其余URL、主機(jī)名等必須成對(duì)加引號(hào)也就是說(shuō)只刪掉#還不夠多數(shù)情況下還要把示例值改成你自己的值。用環(huán)境變量覆蓋配置不想改文件TOML 支持用環(huán)境變量覆蓋任意參數(shù)轉(zhuǎn)換規(guī)則為去掉頂層命名空間 → 把點(diǎn)換成下劃線 → 轉(zhuǎn)大寫(xiě)例如environment.s3.enable對(duì)應(yīng)環(huán)境變量ENVIRONMENT_S3_ENABLE列表則用逗號(hào)分隔。這對(duì) Heroku / Docker 部署尤其友好。二、[configuration.environment]Pod 能不能跑起來(lái)就看這一段這是官方標(biāo)注必須檢查的核心段。1.urlPod 的公網(wǎng)地址最重要url https://example.org/填瀏覽器訪問(wèn) Pod 用的地址用了反向代理就填代理的 URL??初始部署后不要改該地址會(huì)被硬編碼進(jìn)數(shù)據(jù)庫(kù)改成https除外忘了設(shè)置默認(rèn)值是http://localhost:3000/見(jiàn) config/defaults.yml2.certificate_authoritiesCA 證書(shū)包路徑生產(chǎn)環(huán)境必須指定否則 config/load_config.rb 會(huì)直接報(bào)錯(cuò)退出。常見(jiàn)取值Debian / Ubuntu / Arch/etc/ssl/certs/ca-certificates.crtCentOS / Fedora/etc/pki/tls/certs/ca-bundle.crt3.redis連接遠(yuǎn)程 Redis默認(rèn)是localhost。遠(yuǎn)程部署時(shí)寫(xiě)成redis://用戶名:密碼主機(jī):6379/0或 unix socket 形式務(wù)必先限制 IP 訪問(wèn)。4.require_ssl強(qiáng)制 HTTPS默認(rèn) true生產(chǎn)模式會(huì)強(qiáng)制 HTTPS。因?yàn)?OAuth2 和 API 依賴 SSL不建議關(guān)掉否則 API 可能無(wú)法工作。5.image_redirect_url圖片放到外部圖床填上如https://images.example.org后所有/uploads/images請(qǐng)求都會(huì)跳轉(zhuǎn)到外部圖片服務(wù)器適合把圖片流量從主服務(wù)器分流出去。三、[configuration.environment.sidekiq]后臺(tái)任務(wù)引擎的 5 個(gè)旋鈕diaspora* 的聯(lián)邦收發(fā)、郵件、照片處理都靠 Sidekiq 隊(duì)列config/sidekiq.yml 和這一段決定它的脾氣參數(shù)默認(rèn)值通俗解釋concurrency5每個(gè) Sidekiq 工作進(jìn)程的并行線程數(shù)。中型 Pod 可加到 25記得同步調(diào)大數(shù)據(jù)庫(kù)連接池retry10失敗任務(wù)重試次數(shù)設(shè)太高隊(duì)列會(huì)堆積設(shè) 0 關(guān)閉重試backtrace15失敗時(shí)保留多少行堆棧日志設(shè)為false可省 Redis 內(nèi)存dead_jobs_limit5000死信隊(duì)列保留多少條默認(rèn)值越大越占內(nèi)存dead_jobs_timeout3628800死信保留秒數(shù)默認(rèn) 6 周過(guò)期即永久丟失 想提速優(yōu)先調(diào)concurrency而不是加更多 Sidekiq 進(jìn)程。四、存儲(chǔ)與靜態(tài)資源s3 / assets[configuration.environment.s3]照片存到 Amazon S3默認(rèn)關(guān)閉。啟用后需填key、secret、bucket、region四項(xiàng)cache true默認(rèn)會(huì)給 S3 資源加一年期的max-age緩存頭加速加載、減少回源。[configuration.environment.assets]靜態(tài)資源三件套serve讓?xiě)?yīng)用服務(wù)器自己發(fā)靜態(tài)文件生產(chǎn)環(huán)境強(qiáng)烈建議交給 Nginx 等反向代理upload/host把編譯后的 assets 上傳到 S3 或指定 CDN 主機(jī)注意 host 結(jié)尾不要帶/五、[configuration.environment.logging]日志與排錯(cuò)開(kāi)關(guān)參數(shù)默認(rèn)值作用logrotate.enabletrue每天滾動(dòng)切分應(yīng)用日志logrotate.days7日志保留天數(shù)debug.sqlfalse打印每條 SQL 語(yǔ)句性能排查利器debug.federationfalse打印聯(lián)邦收發(fā)的全部 XML調(diào)試跨 Pod 通信必備注意開(kāi)發(fā)環(huán)境下debug.sql在 config/defaults.yml 中默認(rèn)是開(kāi)啟的生產(chǎn)環(huán)境請(qǐng)保持關(guān)閉。六、[configuration.server]控制 script/server 的行為這段決定 script/server 啟動(dòng)時(shí)的表現(xiàn)listen監(jiān)聽(tīng)地址開(kāi)發(fā)環(huán)境默認(rèn)tcp://127.0.0.1:3000生產(chǎn)默認(rèn)unix://tmp/diaspora.sock配合 Nginxrails_environment默認(rèn)development生產(chǎn)部署務(wù)必改成productionpid/stderr_log/stdout_log進(jìn)程與日志文件路徑web_timeout單請(qǐng)求超時(shí)秒數(shù)默認(rèn) 90?？枕憫?yīng)、大圖片上傳失敗就調(diào)大它sidekiq_workersSidekiq 進(jìn)程數(shù)默認(rèn) 1一般不用動(dòng)七、[configuration.privacy]隱私保護(hù)專區(qū)diaspora* 以隱私著稱這一段集中體現(xiàn)了它的價(jià)值觀。1.jquery_cdn默認(rèn) falsefalse時(shí) jQuery 由你的 Pod 自己提供用戶流量完全不經(jīng)過(guò)第三方 CDN——這就是隱私優(yōu)先的默認(rèn)姿態(tài)。2.piwik自托管流量統(tǒng)計(jì)填hostsite_id即可啟用 [Piwik](https://piwik.org 的替代品)——比 Google 分析更尊重用戶隱私。注意它和下面的 CSP 默認(rèn)策略沖突啟用后需調(diào)整 CSP。3.statistics上報(bào)多少統(tǒng)計(jì)給 /statistics 和 NodeInfoPod 默認(rèn)只公開(kāi)名稱、版本、是否開(kāi)放注冊(cè)u(píng)ser_counts、post_counts、comment_counts默認(rèn)全關(guān)。是否開(kāi)放本地用戶/帖子數(shù)統(tǒng)計(jì)由管理員根據(jù)隱私策略自行決定。4.camo用反向代理保護(hù)用戶 IPlib/diaspora/camo.rb 依賴這一段。啟用 Camo 后proxy_markdown_images代理 Markdown 里的外部圖片推薦避免混合內(nèi)容警告proxy_opengraph_thumbnails代理 Open Graph 縮略圖推薦proxy_remote_pod_images連別的 Pod 的頭像照片都代理——隱私最佳但會(huì)大幅增加你的服務(wù)器流量root/keyCamo 服務(wù)地址與共享密鑰?? 三個(gè)代理項(xiàng)都默認(rèn)false請(qǐng)確保 Camo 已部署成功再開(kāi)啟。八、[configuration.settings]運(yùn)營(yíng)你的 Pod 的 20 個(gè)開(kāi)關(guān)這是參數(shù)最多、也最貼近日常運(yùn)營(yíng)的一段?；A(chǔ)信息與注冊(cè)參數(shù)默認(rèn)值說(shuō)明pod_namediaspora*Pod 名稱顯示在頁(yè)頭等各處enable_registrationstrue注冊(cè)開(kāi)關(guān)設(shè)為 false 后只能憑邀請(qǐng)碼加入首個(gè)賬號(hào)注冊(cè)時(shí)它必須是 trueenable_local_posts_streamdisabled本地帖子流可見(jiàn)范圍disabled / admins / moderators / everyoneautofollow_on_jointrue新用戶是否自動(dòng)關(guān)注指定賬號(hào)autofollow_on_join_userhqpod.diaspora.software被自動(dòng)關(guān)注的官方新聞賬號(hào)主題與外觀default_color_theme未登錄或未選擇主題時(shí)的默認(rèn)配色可選值見(jiàn) config/color_themes.ymloriginal、original_white、dark、dark_green、magenta、egyptian_bluedefault_metastitle與description控制全站默認(rèn) meta 標(biāo)簽直接影響搜索引擎展示捐贈(zèng)按鈕可任選其一liberapay_usernameLiberapay 用戶名bitcoin_address比特幣地址paypal_donations小節(jié)enablecurrency再二選一填托管按鈕 ID 或非托管按鈕的加密密鑰邀請(qǐng)、歡迎語(yǔ)與社區(qū)聚光燈invitationsopen默認(rèn) true允許用戶互發(fā)邀請(qǐng)count默認(rèn) 25是每鏈接邀請(qǐng)數(shù)welcome_messageenabled開(kāi)啟后新用戶注冊(cè)會(huì)收到一條站內(nèi)信text中的%{username}會(huì)自動(dòng)替換為新用戶昵稱community_spotlight給帶 spotlight 角色的賬號(hào)做新手指引展示suggest_email可收集用戶推薦安全與訪問(wèn)控制captcha注冊(cè)驗(yàn)證碼enable默認(rèn) true還可調(diào)image_size、captcha_length最長(zhǎng) 12、image_style9 種風(fēng)格、distortionlow/medium/high/randomterms服務(wù)條款開(kāi)關(guān)。enable 必填的jurisdiction管轄法律地區(qū)不填則相關(guān)段落不顯示 可選的minimum_age年齡限制。官方提醒默認(rèn)條款未經(jīng)律師審查嚴(yán)謹(jǐn)場(chǎng)景請(qǐng)咨詢法律專業(yè)人士自定義模板放在app/views/terms/csp內(nèi)容安全策略頭默認(rèn)已啟用report_only改為 true 可先只上報(bào)不攔截report_uri指定上報(bào)地址。改過(guò)模板或加了自定義 JS 的 Pod 需謹(jǐn)慎username_blacklist在 config/defaults.yml 中預(yù)置了 admin、root、postmaster 等 14 個(gè)保留用戶名可在 TOML 中追加性能相關(guān)typhoeus_concurrency默認(rèn) 20與其他 Pod 并行 HTTP 請(qǐng)求上限調(diào)大會(huì)顯著推高 Sidekiq 內(nèi)存占用typhoeus_verbose默認(rèn) false聯(lián)調(diào)聯(lián)邦問(wèn)題的詳細(xì)輸出開(kāi)關(guān)archive_jobs_concurrency默認(rèn) 1并行導(dǎo)入/導(dǎo)出用戶數(shù)據(jù)的任務(wù)數(shù)大賬號(hào)遷移很吃內(nèi)存小服務(wù)器別動(dòng)它九、[configuration.settings.maintenance]自動(dòng)清理不活躍用戶默認(rèn)關(guān)閉。開(kāi)啟后after_days默認(rèn) 730 天無(wú)活動(dòng)即標(biāo)記先發(fā)預(yù)警郵件再過(guò)warn_days默認(rèn) 30 天自動(dòng)注銷limit_removals_to_per_day默認(rèn) 100限制每日清理隊(duì)列量防止誤傷潮。十、[configuration.map.mapbox]帖子地理位置地圖需要到 Mapbox 注冊(cè)獲取access_token然后設(shè)置enabled true與style如mapbox/streets-v11帖子上的位置信息就會(huì)渲染成地圖。十一、[configuration.mail]郵箱沒(méi)配好通知全白搭默認(rèn)enable false不開(kāi)則不發(fā)任何郵件。完整流程enable true、sender_address填發(fā)件人選methodsmtp或sendmailSMTP 分支host、port默認(rèn) 587、authenticationplain / login / cram_md5 / none、username、password、starttls_auto默認(rèn) true自簽名證書(shū)才把openssl_verify_mode設(shè)為nonesendmail 分支location指向 sendmail 可執(zhí)行文件默認(rèn)/usr/sbin/sendmail可加exim_fix十二、[configuration.admins]管理員聯(lián)系信息account通用管理員聯(lián)系賬號(hào)只填用戶名如podmin不是完整 IDpodmin_email管理員聯(lián)系郵箱注意這里不會(huì)把你設(shè)為管理員它只是postmaster 式的通用聯(lián)系方式。十三、高級(jí)技巧分環(huán)境覆蓋與配置查詢文件末尾的[production]、[development]等頂層段可以按環(huán)境覆蓋全局配置例如讓生產(chǎn)環(huán)境用不同的 Redis[production] environment.redis redis://production.example.org:6379想確認(rèn)某個(gè)參數(shù)當(dāng)前生效的值直接用倉(cāng)庫(kù)自帶的 script/get_config.rb./script/get_config.rb settings.pod_name它會(huì)把最終合并結(jié)果打印出來(lái)排查我到底改沒(méi)改生效非常有用。十四、給新手的 5 條上手清單 復(fù)制 config/diaspora.toml.example 為config/diaspora.toml只動(dòng)必須項(xiàng)url、certificate_authorities、rails_environment配好[configuration.mail]否則注冊(cè)確認(rèn)、密碼重置都會(huì)失靈想關(guān)公開(kāi)注冊(cè)enable_registrations false并保留邀請(qǐng)功能改完用./script/get_config.rb抽查關(guān)鍵項(xiàng)再重啟服務(wù)總結(jié)diaspora* 的 TOML 配置雖然參數(shù)多達(dá) 100但 90% 的日常運(yùn)營(yíng)只涉及前八節(jié)的核心開(kāi)關(guān)。記住defaults.yml 兜底、TOML 覆蓋、環(huán)境變量最高這條優(yōu)先級(jí)鏈你就能自信地駕馭任意一個(gè) diaspora* Pod。【免費(fèi)下載鏈接】diasporaA privacy-aware, distributed, open source social network.項(xiàng)目地址: https://gitcode.com/gh_mirrors/di/diaspora創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考