Valour：开源社区社交平台

项目简介

Valour 是一个用 .NET 和 Blazor 构建的开源社区平台。社区在这里被称为「星球」（planet），每个星球可以拥有聊天频道、主题流、Wiki、语音与视频通话、角色权限、经济系统，以及一个成员可以走动相遇的村庄（village）。

客户端支持标签页、分屏和同时打开多个会话。官方提供网页版 app.valour.gg，Android 版可在 Google Play 获取，其他下载入口见 valour.gg。

主要功能

• 星球式社区：聊天频道、主题流、Wiki、角色与权限
• 语音与视频通话
• 星球经济系统与可漫步的村庄
• 客户端支持标签页、分屏、多会话并行
• 机器人使用与客户端相同的 SDK 和 API 约定
• 支持自托管与联邦（federation）部署

安装与使用

普通用户直接访问 app.valour.gg 或安装移动端应用即可。

自托管使用仓库根目录的 Docker Compose 套件，包含 Valour、PostgreSQL、Redis、Caddy 和文件系统媒体存储。需要把公网域名指向主机，并放行 80、443 端口：

cp .env.example .env
docker compose up -d

编辑 .env 设置域名、数据库密码、初始管理员凭据以及 DATAPROTECTION__KEK（可用 openssl rand -base64 32 生成，需与数据库备份分开保存）。缺少该密钥时 Compose 会拒绝启动。Caddy 负责申请 HTTPS 证书并反向代理应用。

若要作为联邦中的社区节点运行，可执行 ./scripts/valour-node-setup 向导配置域名与 hub；不配置联邦时，Compose 部署即为独立实例。

本地开发需要 global.json 中建议的 SDK 版本、PostgreSQL 与 Redis，然后：

dotnet workload restore
dotnet restore
dotnet run --project Valour/Server/Valour.Server.csproj

注意事项

• 只有 Compose 文件已映射的 .env 变量才会传入容器，额外设置需要写进服务环境或 Compose override。
• 移动端 Debug 构建可通过 Valour/Client.Maui/Local.props 中的 ValourApiBase 连接局域网内的本地服务器，Release 构建始终使用官方 HTTPS API。
• macOS 版是同一项目的 Mac Catalyst 构建，签名与 Touch ID 登录依赖 Apple 团队证书。
• 项目使用 AGPL-3.0 许可证；「Valour」是 Valour Software LLC 的商标，分支或衍生项目未经书面许可不得使用该名称与相关品牌。

---

本作品整理自 GitHub 开源项目 Valour-Software/Valour，原作者 @Valour-Software，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。