atena/wekan

atena/wekan Docker镜像文档

镜像概述

atena/wekan是基于mquandalle/wekan v0.10.1版本构建的Docker镜像，在原版本基础上扩展了实用功能。该镜像主要用于提供增强版的Wekan看板服务，特别适合需要数据迁移和日语环境支持的用户。

核心功能与特性

• 数据导入导出：新增Excel TSV/CSV格式的数据导入导出功能（基于https://github.com/wekan/wekan/pull/413%E8%A1%A5%E4%B8%81%EF%BC%89%EF%BC%8C%E6%96%B9%E4%BE%BF%E7%94%A8%E6%88%B7%E8%BF%9B%E8%A1%8C%E6%95%B0%E6%8D%AE%E5%A4%87%E4%BB%BD%E4%B8%8E%E8%BF%81%E7%A7%BB%E3%80%82
• 日语翻译优化：添加并更新了日语翻译内容，完善了部分原未日语化的菜单，提升日语用户体验。

使用场景

• 需要在Wekan看板之间迁移数据的团队或个人
• 日语环境下使用Wekan看板的用户
• 对数据备份有需求的Wekan用户

安装与使用指南

前提条件

• 已安装Docker Engine
• 已安装Docker Compose

安装步骤

1. 安装Docker（Ubuntu系统）

参考Docker官方文档：Docker Engine安装指南

2. 安装Docker Compose

参考Docker官方文档：Docker Compose安装指南

3. 创建专用用户

bash
# 创建wekan用户并设置家目录
useradd -d /home/wekan -m -s /bin/bash wekan
# 将用户添加到docker组以允许管理容器
usermod -aG docker wekan

4. 创建docker-compose.yml配置文件

切换到wekan用户并创建配置文件：

bash
su - wekan
vi docker-compose.yml

配置文件内容：

yaml
wekan:
  image: atena/wekan
  links:
    - wekandb
  environment:
    - MONGO_URL=mongodb://wekandb/wekan  # MongoDB连接地址
    - ROOT_URL=http://localhost:8081     # Wekan访问URL
  ports:
    - 8081:80  # 端口映射：主机8081端口映射到容器80端口
  restart: always  # 容器退出时自动重启

wekandb:
  image: mongo  # 使用官方MongoDB镜像
  volumes:
    - /home/wekan/data:/data/db  # 数据持久化：主机目录映射到容器数据目录
  restart: always  # 容器退出时自动重启

5. 启动服务

bash
docker-compose up -d

配置说明

环境变量

端口映射

• 主机端口：8081（可根据需求修改）
• 容器端口：80（Wekan服务默认端口）

数据持久化

MongoDB数据通过卷挂载/home/wekan/data:/data/db实现持久化，确保容器重启后数据不丢失。

服务管理

• 查看运行状态：docker-compose ps
• 停止服务：docker-compose down
• 重启服务：docker-compose restart
• 查看日志：docker-compose logs -f