如何自建diaspora* Pod从环境准备到生产部署的完整指南【免费下载链接】diasporaA privacy-aware, distributed, open source social network.项目地址: https://gitcode.com/gh_mirrors/di/diasporadiaspora*是一个注重隐私、分布式、开源的社交网络。它没有中央服务器而是由一个个自治的节点Pod组成各 Pod 之间通过联邦协议互通用户数据完全归属自己的 Pod——这正是自建 diaspora* Pod 的核心价值。本文是一份面向新手的生产部署教程带你从零完成环境准备、数据库配置、静态资源编译到 Nginx 反向代理上线的完整流程。什么是 diaspora* Pod可以把 diaspora* 理解为一个“联邦制”社交网络Pod节点你自建的服务器实例承载注册到你这里的所有用户联邦协议不同 Pod 之间可以互相关注、发消息、评论用户无需迁移即可跨 Pod 互动数据主权帖子、照片、联系人数据都存在你自己 Pod 的数据库里随时可导出迁移。自建一个 Pod 相当于运营一个小型社交平台既适合自己团队内部交流也可以公开接受注册加入全球 diaspora* 网络。部署前需要准备的 6 样东西在动手之前请确认服务器上具备以下依赖以 Ubuntu/Debian 为例组件版本建议用途Ruby3.3应用运行时版本要求见 .ruby-versionPostgreSQL13主数据库也支持 MySQLRedis7.xSidekiq 后台任务队列Node.js Yarn较新版本编译前端静态资源ImageMagick6.x / 7.x照片缩放与水印处理Nginx1.20反向代理与 HTTPS 终结此外还需要一台能访问公网的服务器2 核 2G 起步推荐 4G 内存一个指向服务器的域名如social.example.org及有效的 SSL 证书项目源码可执行git clone https://gitcode.com/gh_mirrors/di/diaspora获取。 如果只是想先在本地体验仓库提供了 docker/develop/docker-compose.yml一条docker compose up就能拉起应用、PostgreSQL 和 Redis 的完整开发环境。第一步获取源码并安装依赖git clone https://gitcode.com/gh_mirrors/di/diaspora cd diaspora bundle installdocker/develop/Dockerfile 展示了官方推荐的完整系统依赖清单包括imagemagick、libpq-dev、libxml2-dev、nodejs、yarn等可作为裸机安装时的对照清单apt-get install -y build-essential cmake git imagemagick \ libpq-dev libxml2-dev libxslt1-dev libmagickwand-dev \ nodejs npm gosu npm install -g yarn第二步配置数据库连接将示例配置复制为正式配置并修改连接信息cp config/database.yml.example config/database.yml打开 config/database.yml.example你会看到默认使用 PostgreSQL需要修改host、username、password为你的数据库实际参数如果偏好 MySQL取消: *mysql一行的注释即可。创建对应的数据库用户并记住 config/defaults.yml 中 Sidekiq 并发数默认是 5数据库连接池pool建议与其保持一致。第三步配置 diaspora.toml关键一步cp config/diaspora.toml.example config/diaspora.tomlconfig/diaspora.toml.example 是 Pod 的核心配置文件生产环境至少要关注以下几项[configuration.environment] # ⚠️ 你的 Pod 公网访问地址初始化后不可随意修改 url https://social.example.org/ require_ssl true [configuration.server] # 生产环境使用 Unix Socket由 Nginx 转发 listen unix://tmp/diaspora.sock rails_environment production sidekiq_workers 1 [configuration.settings] pod_name 我的社区 enable_registrations true [configuration.mail] enable true sender_address no-replysocial.example.org method smtp host smtp.example.org [configuration.admins] account podmin # 首个管理员账号的用户名 podmin_email adminexample.org⚠️重要提醒url会被硬编码写入数据库初始化之后修改会导致 Pod 异常请务必先想好域名再写入require_ssl在 OAuth2/API 场景下建议保持true。第四步构建数据库RAILS_ENVproduction bin/rake db:setup这一步会建库、执行迁移并加载初始结构。核心迁移位于 db/migrate/ 目录。第五步预编译静态资源RAILS_ENVproduction bin/rake assets:precompilescript/server 启动脚本会强制检查public/assets/下是否存在预编译产物生产环境必须执行此步骤否则服务会拒绝启动。每次更新代码后都需要重新执行。第六步启动服务仓库通过 Procfile 定义了两个常驻进程web: bin/puma -C config/puma.rb sidekiq: bin/bundle exec sidekiqwebPuma处理 HTTP 请求配置来自 config/puma.rbsidekiq处理发帖、联邦投递、图片处理等后台任务见 app/workers/ 目录。开发/测试环境可以直接运行./script/server一键拉起两个进程生产环境推荐用foreman start或 systemd 分别托管 Puma 和 Sidekiq。第七步Nginx 反向代理与 HTTPS生产部署的最后一步是让 Nginx 终结 SSL 并转发到 Unix Socketserver { listen 443 ssl http2; server_name social.example.org; ssl_certificate /etc/letsencrypt/live/social.example.org/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/social.example.org/privkey.pem; location / { proxy_pass unix:/var/www/diaspora/tmp/diaspora.sock; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto https; client_max_body_size 100m; # 允许较大图片上传 } }随后访问https://social.example.org注册第一个账号即配置中的admins.account它就自动成为 Pod 管理员可登录后台管理页面调整注册策略、邀请码默认每人 25 个、欢迎语、服务条款等——这些选项都对应 config/diaspora.toml.example 中的settings段也可以在 Web 界面直接修改。上线后的 3 个建议定期更新拉取新代码后依次执行bundle install→bin/rake db:migrate→bin/rake assets:precompile→ 重启服务监控 Sidekiq 队列关注log/sidekiq.log投递失败会进入死信队列保留约 6 周可在配置中调整保护用户隐私保持require_ssl true谨慎开启统计与第三方追踪相关配置。总结自建 diaspora* Pod 的核心流程只有 7 步装依赖 → 配数据库 → 配 diaspora.toml → 建库 → 编译资源 → 启动 PumaSidekiq → Nginx 上 HTTPS。整个仓库的配置项在 config/diaspora.toml.example 中都有详尽的中文级注释遇到问题时它是最好的参考资料。当你的 Pod 成功加入 diaspora* 联邦网络的那一刻你就拥有了一个完全自主、注重隐私的社交空间 【免费下载链接】diasporaA privacy-aware, distributed, open source social network.项目地址: https://gitcode.com/gh_mirrors/di/diaspora创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何自建diaspora* Pod：从环境准备到生产部署的完整指南
如何自建diaspora* Pod从环境准备到生产部署的完整指南【免费下载链接】diasporaA privacy-aware, distributed, open source social network.项目地址: https://gitcode.com/gh_mirrors/di/diasporadiaspora*是一个注重隐私、分布式、开源的社交网络。它没有中央服务器而是由一个个自治的节点Pod组成各 Pod 之间通过联邦协议互通用户数据完全归属自己的 Pod——这正是自建 diaspora* Pod 的核心价值。本文是一份面向新手的生产部署教程带你从零完成环境准备、数据库配置、静态资源编译到 Nginx 反向代理上线的完整流程。什么是 diaspora* Pod可以把 diaspora* 理解为一个“联邦制”社交网络Pod节点你自建的服务器实例承载注册到你这里的所有用户联邦协议不同 Pod 之间可以互相关注、发消息、评论用户无需迁移即可跨 Pod 互动数据主权帖子、照片、联系人数据都存在你自己 Pod 的数据库里随时可导出迁移。自建一个 Pod 相当于运营一个小型社交平台既适合自己团队内部交流也可以公开接受注册加入全球 diaspora* 网络。部署前需要准备的 6 样东西在动手之前请确认服务器上具备以下依赖以 Ubuntu/Debian 为例组件版本建议用途Ruby3.3应用运行时版本要求见 .ruby-versionPostgreSQL13主数据库也支持 MySQLRedis7.xSidekiq 后台任务队列Node.js Yarn较新版本编译前端静态资源ImageMagick6.x / 7.x照片缩放与水印处理Nginx1.20反向代理与 HTTPS 终结此外还需要一台能访问公网的服务器2 核 2G 起步推荐 4G 内存一个指向服务器的域名如social.example.org及有效的 SSL 证书项目源码可执行git clone https://gitcode.com/gh_mirrors/di/diaspora获取。 如果只是想先在本地体验仓库提供了 docker/develop/docker-compose.yml一条docker compose up就能拉起应用、PostgreSQL 和 Redis 的完整开发环境。第一步获取源码并安装依赖git clone https://gitcode.com/gh_mirrors/di/diaspora cd diaspora bundle installdocker/develop/Dockerfile 展示了官方推荐的完整系统依赖清单包括imagemagick、libpq-dev、libxml2-dev、nodejs、yarn等可作为裸机安装时的对照清单apt-get install -y build-essential cmake git imagemagick \ libpq-dev libxml2-dev libxslt1-dev libmagickwand-dev \ nodejs npm gosu npm install -g yarn第二步配置数据库连接将示例配置复制为正式配置并修改连接信息cp config/database.yml.example config/database.yml打开 config/database.yml.example你会看到默认使用 PostgreSQL需要修改host、username、password为你的数据库实际参数如果偏好 MySQL取消: *mysql一行的注释即可。创建对应的数据库用户并记住 config/defaults.yml 中 Sidekiq 并发数默认是 5数据库连接池pool建议与其保持一致。第三步配置 diaspora.toml关键一步cp config/diaspora.toml.example config/diaspora.tomlconfig/diaspora.toml.example 是 Pod 的核心配置文件生产环境至少要关注以下几项[configuration.environment] # ⚠️ 你的 Pod 公网访问地址初始化后不可随意修改 url https://social.example.org/ require_ssl true [configuration.server] # 生产环境使用 Unix Socket由 Nginx 转发 listen unix://tmp/diaspora.sock rails_environment production sidekiq_workers 1 [configuration.settings] pod_name 我的社区 enable_registrations true [configuration.mail] enable true sender_address no-replysocial.example.org method smtp host smtp.example.org [configuration.admins] account podmin # 首个管理员账号的用户名 podmin_email adminexample.org⚠️重要提醒url会被硬编码写入数据库初始化之后修改会导致 Pod 异常请务必先想好域名再写入require_ssl在 OAuth2/API 场景下建议保持true。第四步构建数据库RAILS_ENVproduction bin/rake db:setup这一步会建库、执行迁移并加载初始结构。核心迁移位于 db/migrate/ 目录。第五步预编译静态资源RAILS_ENVproduction bin/rake assets:precompilescript/server 启动脚本会强制检查public/assets/下是否存在预编译产物生产环境必须执行此步骤否则服务会拒绝启动。每次更新代码后都需要重新执行。第六步启动服务仓库通过 Procfile 定义了两个常驻进程web: bin/puma -C config/puma.rb sidekiq: bin/bundle exec sidekiqwebPuma处理 HTTP 请求配置来自 config/puma.rbsidekiq处理发帖、联邦投递、图片处理等后台任务见 app/workers/ 目录。开发/测试环境可以直接运行./script/server一键拉起两个进程生产环境推荐用foreman start或 systemd 分别托管 Puma 和 Sidekiq。第七步Nginx 反向代理与 HTTPS生产部署的最后一步是让 Nginx 终结 SSL 并转发到 Unix Socketserver { listen 443 ssl http2; server_name social.example.org; ssl_certificate /etc/letsencrypt/live/social.example.org/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/social.example.org/privkey.pem; location / { proxy_pass unix:/var/www/diaspora/tmp/diaspora.sock; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto https; client_max_body_size 100m; # 允许较大图片上传 } }随后访问https://social.example.org注册第一个账号即配置中的admins.account它就自动成为 Pod 管理员可登录后台管理页面调整注册策略、邀请码默认每人 25 个、欢迎语、服务条款等——这些选项都对应 config/diaspora.toml.example 中的settings段也可以在 Web 界面直接修改。上线后的 3 个建议定期更新拉取新代码后依次执行bundle install→bin/rake db:migrate→bin/rake assets:precompile→ 重启服务监控 Sidekiq 队列关注log/sidekiq.log投递失败会进入死信队列保留约 6 周可在配置中调整保护用户隐私保持require_ssl true谨慎开启统计与第三方追踪相关配置。总结自建 diaspora* Pod 的核心流程只有 7 步装依赖 → 配数据库 → 配 diaspora.toml → 建库 → 编译资源 → 启动 PumaSidekiq → Nginx 上 HTTPS。整个仓库的配置项在 config/diaspora.toml.example 中都有详尽的中文级注释遇到问题时它是最好的参考资料。当你的 Pod 成功加入 diaspora* 联邦网络的那一刻你就拥有了一个完全自主、注重隐私的社交空间 【免费下载链接】diasporaA privacy-aware, distributed, open source social network.项目地址: https://gitcode.com/gh_mirrors/di/diaspora创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考