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