webhippie/kanboard

kanboard

https://github.com/dockhippie/kanboard/actions/workflows/docker.yml/badge.svg](https://github.com/dockhippie/kanboard/actions/workflows/docker.yml)

这是基于 https://github.com/dockhippie/php-apache 运行的 https://github.com/kanboard/kanboard Docker 镜像。Kanboard 是一款简单易用的项目管理工具，专注于任务看板和项目协作，帮助团队高效管理任务和项目进度。

版本

可用版本请查看 https://hub.docker.com/r/webhippie/kanboard/tags、Quay 或 https://github.com/dockhippie/kanboard 中的现有文件夹。

数据卷

• /var/lib/kanboard （存储 Kanboard 数据，包括数据库、缓存和插件等）

端口

• 8080 （Web 服务端口）

可用环境变量

console
KANBOARD_API_AUTHENTICATION_HEADER = （API 认证请求头）
KANBOARD_BASE_DIR = /var/lib/kanboard （基础目录）
KANBOARD_BRUTEFORCE_CAPTCHA = 3 （触发验证码的失败登录次数）
KANBOARD_BRUTEFORCE_LOCKDOWN = 6 （触发账户锁定的失败登录次数）
KANBOARD_BRUTEFORCE_LOCKDOWN_DURATION = 15 （账户锁定时长，单位：分钟）
KANBOARD_CACHE_DIR = ${KANBOARD_BASE_DIR}/cache （缓存目录）
KANBOARD_CACHE_DRIVER = memory （缓存驱动，默认为内存）
KANBOARD_DASHBOARD_MAX_PROJECTS = 10 # v1.2版本新增（仪表盘显示的最大项目数）
KANBOARD_DATA_DIR = ${KANBOARD_BASE_DIR}/data （数据目录）
KANBOARD_DB_DRIVER = sqlite （数据库驱动，默认为SQLite）
KANBOARD_DB_HOSTNAME = （数据库主机名）
KANBOARD_DB_NAME = /var/lib/kanboard/database.sqlite3 （数据库名称，SQLite时为文件路径）
KANBOARD_DB_ODBC_DSN = kanboard # v1.2版本新增（ODBC数据源名称）
KANBOARD_DB_PASSWORD = （数据库密码）
KANBOARD_DB_PORT = （数据库端口）
KANBOARD_DB_RUN_MIGRATIONS = true （是否自动运行数据库迁移）
KANBOARD_DB_SSL_CA = （数据库SSL CA证书路径）
KANBOARD_DB_SSL_CERT = （数据库SSL证书路径）
KANBOARD_DB_SSL_KEY = （数据库SSL密钥路径）
KANBOARD_DB_TIMEOUT = # v1.2版本新增（数据库连接超时时间）
KANBOARD_DB_USERNAME = （数据库用户名）
KANBOARD_DB_VERIFY_SERVER_CERT = # v1.2版本新增（是否验证数据库服务器证书）
KANBOARD_DB_WAIT_FOR_FAIL = true （数据库连接失败时是否等待）
KANBOARD_DEBUG = false （是否启用调试模式）
KANBOARD_DISABLE_LOGOUT = false （是否禁用登出功能）
KANBOARD_ENABLE_HSTS = true （是否启用HSTS）
KANBOARD_ENABLE_URL_REWRITE = true （是否启用URL重写）
KANBOARD_ENABLE_XFRAME = true （是否启用X-Frame-Options头）
KANBOARD_EXTERNAL_AUTH_EXCLUDE_FIELDS = username # v1.1版本新增（外部认证排除字段）
KANBOARD_FILES_DIR = ${KANBOARD_BASE_DIR}/files （文件存储目录）
KANBOARD_HIDE_LOGIN_FORM = false （是否隐藏登录表单）
KANBOARD_HTTP_PROXY_EXCLUDE = localhost # v1.2版本新增（HTTP代理排除主机）
KANBOARD_HTTP_PROXY_HOSTNAME = （HTTP代理主机名）
KANBOARD_HTTP_PROXY_PASSWORD = （HTTP代理密码）
KANBOARD_HTTP_PROXY_PORT = 3128 （HTTP代理端口）
KANBOARD_HTTP_PROXY_USERNAME = （HTTP代理用户名）
KANBOARD_HTTP_VERIFY_SSL_CERTIFICATE = true （是否验证HTTPS SSL证书）
KANBOARD_LDAP_AUTH = false （是否启用LDAP认证）
KANBOARD_LDAP_BIND_TYPE = anonymous （LDAP绑定类型，默认为匿名）
KANBOARD_LDAP_GROUP_ADMIN_DN = （LDAP管理员组DN）
KANBOARD_LDAP_GROUP_ATTRIBUTE_NAME = cn （LDAP组属性名称）
KANBOARD_LDAP_GROUP_BASE_DN = （LDAP组基础DN）
KANBOARD_LDAP_GROUP_FILTER = （LDAP组过滤条件）
KANBOARD_LDAP_GROUP_MANAGER_DN = （LDAP组管理员DN）
KANBOARD_LDAP_GROUP_PROVIDER = false （是否启用LDAP组提供器）
KANBOARD_LDAP_GROUP_SYNC = true # v1.2版本新增（是否同步LDAP组）
KANBOARD_LDAP_GROUP_USER_ATTRIBUTE = username # v1.2版本新增（LDAP组用户属性）
KANBOARD_LDAP_GROUP_USER_FILTER = （LDAP组用户过滤条件）
KANBOARD_LDAP_PASSWORD = （LDAP密码）
KANBOARD_LDAP_PORT = 389 （LDAP端口）
KANBOARD_LDAP_SERVER = （LDAP服务器地址）
KANBOARD_LDAP_SSL_VERIFY = true （是否验证LDAP SSL证书）
KANBOARD_LDAP_START_TLS = false （是否启用LDAP STARTTLS）
KANBOARD_LDAP_USER_ATTRIBUTE_EMAIL = mail （LDAP用户邮箱属性）
KANBOARD_LDAP_USER_ATTRIBUTE_FULLNAME = cn （LDAP用户全名属性）
KANBOARD_LDAP_USER_ATTRIBUTE_GROUPS = memberof （LDAP用户组属性）
KANBOARD_LDAP_USER_ATTRIBUTE_LANGUAGE = （LDAP用户语言属性）
KANBOARD_LDAP_USER_ATTRIBUTE_PHOTO = （LDAP用户头像属性）
KANBOARD_LDAP_USER_ATTRIBUTE_USERNAME = uid （LDAP用户用户名属性）
KANBOARD_LDAP_USER_BASE_DN = （LDAP用户基础DN）
KANBOARD_LDAP_USER_CREATION = true （是否自动创建LDAP用户）
KANBOARD_LDAP_USER_DEFAULT_ROLE_MANAGER = false # v1.2版本新增（LDAP用户默认角色是否为管理员）
KANBOARD_LDAP_USER_FILTER = （LDAP用户过滤条件）
KANBOARD_LDAP_USERNAME = （LDAP用户名）
KANBOARD_LDAP_USERNAME_CASE_SENSITIVE = false （LDAP用户名是否区分大小写）
KANBOARD_LOG_DRIVER = stderr （日志驱动）
KANBOARD_LOG_FILE = ${KANBOARD_BASE_DIR}/debug.log （日志文件路径）
KANBOARD_MAIL_BCC = # v1.2版本新增（邮件密送地址）
KANBOARD_MAIL_CONFIGURATION = true （是否启用邮件配置）
KANBOARD_MAIL_FROM = kanboard@example.com （发件人邮箱）
KANBOARD_MAIL_SENDMAIL_COMMAND = /usr/sbin/sendmail -bs （Sendmail命令）
KANBOARD_MAIL_SMTP_ENCRYPTION = （SMTP加密方式，可选tls/ssl）
KANBOARD_MAIL_SMTP_HELO_NAME = # v1.2版本新增（SMTP HELO名称）
KANBOARD_MAIL_SMTP_HOSTNAME = localhost （SMTP主机名）
KANBOARD_MAIL_SMTP_PASSWORD = （SMTP密码）
KANBOARD_MAIL_SMTP_PORT = 25 （SMTP端口）
KANBOARD_MAIL_SMTP_USERNAME = （SMTP用户名）
KANBOARD_MAIL_TRANSPORT = mail （邮件传输方式，可选mail/smtp/sendmail）
KANBOARD_MARKDOWN_ESCAPE_HTML = true （是否转义Markdown中的HTML）
KANBOARD_PLUGIN_API_URL = https://kanboard.org/plugins.json （插件API URL）
KANBOARD_PLUGIN_INSTALLER = true （是否启用插件安装器）
KANBOARD_PLUGINS_DIR = ${KANBOARD_BASE_DIR}/plugins （插件目录）
KANBOARD_REMEMBER_ME_AUTH = true （是否启用"记住我"认证）
KANBOARD_REVERSE_PROXY_AUTH = false （是否启用反向代理认证）
KANBOARD_REVERSE_PROXY_DEFAULT_ADMIN = （反向代理默认管理员用户名）
KANBOARD_REVERSE_PROXY_DEFAULT_DOMAIN = （反向代理默认域名）
KANBOARD_REVERSE_PROXY_EMAIL_HEADER = REMOTE_EMAIL # v1.2版本新增（反向代理邮箱头）
KANBOARD_REVERSE_PROXY_FULLNAME_HEADER = REMOTE_NAME # v1.2版本新增（反向代理全名头）
KANBOARD_REVERSE_PROXY_USER_HEADER = REMOTE_USER （反向代理用户头）
KANBOARD_SESSION_DURATION = 0 （会话时长，0表示浏览器会话）
KANBOARD_SESSION_HANDLER = db # v1.2版本新增（会话处理器）
KANBOARD_SHOW_GROUP_MEMBERSHIPS_IN_USERLIST = true # v1.2版本新增（用户列表是否显示组成员）
KANBOARD_SHOW_GROUP_MEMBERSHIPS_IN_USERLIST_WITH_LIMIT = 7 # v1.2版本新增（用户列表组成员显示数量限制）
KANBOARD_SKIP_CHOWN = false （是否跳过目录权限设置）
KANBOARD_TOTP_ISSUER = Kanboard （TOTP发行者名称）

继承的环境变量

• https://github.com/dockhippie/php-apache#available-environment-variables
• https://github.com/dockhippie/apache#available-environment-variables
• https://github.com/dockhippie/alpine#available-environment-variables

部署示例

基本运行命令

bash
docker run -d \
  -p 8080:8080 \
  -v kanboard_data:/var/lib/kanboard \
  --name kanboard \
  webhippie/kanboard

Docker Compose 配置

yaml
version: '3'
services:
  kanboard:
    image: webhippie/kanboard
    ports:
      - "8080:8080"
    volumes:
      - kanboard_data:/var/lib/kanboard
    environment:
      - KANBOARD_DB_DRIVER=mysql
      - KANBOARD_DB_HOSTNAME=db
      - KANBOARD_DB_USERNAME=kanboard
      - KANBOARD_DB_PASSWORD=securepassword
      - KANBOARD_DB_NAME=kanboard
    depends_on:
      - db
  db:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DATABASE=kanboard
      - MYSQL_USER=kanboard
      - MYSQL_PASSWORD=securepassword
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  kanboard_data:
  mysql_data: