adhocratie/wekan

Adhocratie Docker镜像文档

概述

Adhocratie是一个强大的现代企业与团队协作管理解决方案，基于AGPL 3.0许可开源，支持社区贡献。该项目旨在提供易于设置、维护、集成且功能全面的协作平台，定位为企业级完整解决方案。

核心功能和特性

集成组件

Adhocratie包含以下核心组件：

• AdhoCore：用户管理、组件集成等核心服务
• Keycloak：集中式用户管理和单点登录系统
• Mailu服务器：具备别名、自动回复、自动转发、反垃圾邮件等高级功能的邮件服务器
• Radicale：用户日历和地址簿托管服务
• Jitsi Meet：视频会议工具
• Outline：团队知识库与维基系统
• Mattermost：团队消息与ChatOps工具（类Slack替代方案）
• Wekan：全功能看板系统
• Scrumblr：敏捷与可视化会议的便签板工具
• Seatable：自托管电子表格-数据库混合系统（类Airtable替代方案）
• Metabase：报表和数据分析工具
• Roundcube：流行的开源网页邮件客户端
• Zpush：Exchange ActiveSync网关

组件集成能力

各组件深度集成，支持以下场景：

• 从Mattermost创建Jitsi会议并向所有参与者发送iCalendar RSVP事件
• 将Seatable数据与Metabase同步，构建强大的数据仪表板
• 在Outline文档中集成富内容（Seatable表格、Wekan看板、Drawio图表、Metabase仪表板）
• 从网页邮件或Exchange网关访问全局地址列表（GAL）
• 从Mattermost搜索Outline文档

使用场景和适用范围

适用于需要综合协作工具的企业、团队或组织，特别适合：

• 远程团队协作与沟通
• 项目管理与任务跟踪
• 知识管理与文档协作
• 视频会议与在线会议
• 数据管理与分析
• 邮件与日历协同

安装与配置

前提条件

域名

需为平台选择主域名（如mycompany.com），此选择至关重要，因为：

• 服务将通过{{service}}.masterdomain.com访问
• 平台***地址格式为{{user}}@masterdomain.com（若使用Adhocratie邮件服务器）

服务器要求

支持运行Docker和Docker-compose的任何操作系统（本教程以Debian为例），最低配置：

• 4GB RAM（推荐8GB+）
• 2个CPU核心（推荐4+）
• 足够的网络带宽（用于视频会议）
• 10GB存储空间（根据需求调整）
• 启用出站SMTP（用于邮件服务器功能）

服务器可部署在封闭网络中，仅内部访问；若使用邮件功能，需配置出站SMTP路由。

DNS配置

需设置以下DNS记录以确保服务可访问：

以下DNS记录可在服务器部署后设置（DKIM密钥动态生成），与邮件服务器功能相关（不使用邮件可忽略）：

通配符TLS证书

需为主域名准备通配符证书，可从SSL提供商购买（生产环境推荐）或使用Let's Encrypt。

使用certbot获取Let's Encrypt通配符证书示例：

bash
certbot certonly \
  --server https://acme-v02.api.letsencrypt.org/directory \
  --manual \
  -d '*.mycompany.com' \
  --preferred-challenges dns

平台部署步骤

在目标服务器上执行以下操作：

1. 安装Docker和Docker-compose

参考官方文档：

• Docker引擎安装
• Docker Compose安装

2. 禁用主机上的SMTP服务器（避免与Mailu冲突）

bash
# 以exim4为例
systemctl stop exim4
systemctl disable exim4

3. 克隆adho-compose仓库

bash
git clone https://github.com/adhocratie/adho-compose.git

4. 生成配置

config.yml文件包含平台所有必要配置，大部分参数有注释说明。

• 确保设置platform.domain及相关平台参数
• 替换默认密码为安全密码（参考注释指导）

生成配置：

bash
cd adh-compose
./gen_conf

5. 部署通配符证书

将证书文件放置在ssl目录下，结构如下：

ssl
├── cert.pem      -> 通配符证书（完整链）
├── key.pem       -> 关联私钥
└── PLACEHOLDER

6. 运行部署

bash
./deploy

7. 创建管理员账户

bash
docker-compose run sanji /scripts/add_admin_user John Doe john.doe@mydomain.com

8. 完成管理员账户配置

访问https://manage.platformdomain，按照账户配置向导操作。

9. 完成平台配置

在管理界面的"团队"部分更新：

• 团队名称和logo
• 邮件相关DNS记录（若使用邮件服务器功能）

支持与文档

• 详细文档：[***]
• 社区讨论与支持：[***]
• 企业级私有云与PaaS服务：[***]

支持我们

Adhocratie功能强大且开源，欢迎使用并分享。我们营销预算有限，恳请您帮助传播。