hasangnu/wekan

Wekan Docker镜像文档

概述

Wekan是一款开源的看板应用，类似于Trello，用于任务管理和项目协作。本Docker部署方案通过Docker Compose实现Wekan应用与MongoDB数据库的一体化部署，简化安装流程，便于快速搭建和使用。

核心功能与特性

• 看板管理：创建自定义看板，组织任务和项目流程
• 任务跟踪：通过卡片形式管理任务，支持拖拽操作和状态更新
• 协作功能：支持多用户协作，任务分配和进度跟踪
• 可配置性：通过环境变量自定义应用行为，如邮件通知、API访问等
• 数据持久化：使用MongoDB存储数据，确保数据安全和持久化

使用场景

• 团队项目管理与任务分配
• 敏捷开发流程跟踪
• 个人待办事项管理
• 项目进度可视化展示

使用方法与配置说明

前提条件

• 已安装Docker和Docker Compose
• 具备基本的Docker命令操作能力

部署示例

Docker Compose配置

创建docker-compose.yml文件，内容如下：

yaml
version: '2'

services:
  wekandb:
    image: hasangnu/mongo:4
    container_name: wekan-db
    restart: always
    command: mongod --oplogSize 128
    networks:
      - wekan-tier
    expose:
      - 27017
    volumes:
      - wekan-db:/data/db
      - wekan-db-dump:/dump

  wekan:
    image: hasangnu/wekan
    container_name: wekan-app
    restart: always
    networks:
      - wekan-tier
    ports:
      - 7080:8080
    environment:
      - MONGO_URL=mongodb://wekandb:27017/wekan
      - ROOT_URL=http://localhost  # 仅在本地安装时使用
      - MAIL_URL=smtp://<mail_url>:25/?ignoreTLS=true&tls={rejectUnauthorized:false}
      - MAIL_FROM=Wekan Notifications <noreply.wekan@mydomain.com>
      - WITH_API=true
      - RICHER_CARD_COMMENT_EDITOR=false
      - CARD_OPENED_WEBHOOK_ENABLED=false
      - BIGEVENTS_PATTERN=NONE
      - BROWSER_POLICY_ENABLED=true
    depends_on:
      - wekandb

volumes:
  wekan-db:
    driver: local
  wekan-db-dump:
    driver: local

networks:
  wekan-tier:
    driver: bridge

启动服务

在docker-compose.yml文件所在目录执行以下命令启动服务：

bash
docker-compose up -d

访问应用

服务启动后，通过浏览器访问 http://localhost:7080 即可使用Wekan应用。

关键配置说明

服务组成

• wekandb：MongoDB数据库服务，版本4，用于存储Wekan应用数据
• wekan：Wekan应用服务，基于Node.js构建，提供Web界面和功能

环境变量配置

数据持久化

• wekan-db卷：存储MongoDB数据库文件，确保数据持久化
• wekan-db-dump卷：用于数据库备份

网络配置

• wekan-tier网络：桥接模式，用于Wekan应用与数据库之间的通信

注意事项

• ROOT_URL需根据实际访问地址修改，如部署在服务器上需改为服务器IP或域名
• 邮件配置需替换为实际SMTP服务器信息以启用通知功能
• 首次使用需注册管理员账户，后续可创建看板和邀请团队成员
• 如需调整端口映射，可修改ports配置中的主机端口（左侧数值）