jcpd/docker-dotclear

README

!稳定镜像版本 !Docker镜像大小 !稳定镜像下载量

!https://github.com/JcDenis/docker-dotclear/actions/workflows/release_stable.yml/badge.svg !https://github.com/JcDenis/docker-dotclear/actions/workflows/release_testing.yml/badge.svg !https://github.com/JcDenis/docker-dotclear/actions/workflows/release_unstable.yml/badge.svg

1. 快速启动

在已安装Docker的目标服务器上，执行：

docker run -d --name dotclear -p 80:80 -v dotclear:/var/www/dotclear jcpd/docker-dotclear

或在已安装Docker Compose的服务器上，执行：

curl -fsSL -o docker-compose.yaml https://raw.githubusercontent.com/JcDenis/docker-dotclear/refs/heads/master/docker-compose.yaml && docker-compose up -d

2. 什么是Dotclear

Dotclear是一款开源网络发布软件。掌控你的博客！

Dotclear项目旨在提供一个用户友好的工具，让任何人无论技术水平如何，都能在网络上发布内容。

=> [***]

3. 什么是docker-dotclear

本仓库包含在Docker环境中构建或运行Dotclear的所有功能。它主要基于https://github.com/darknao/docker-dotclear%E7%9A%84%E5%B7%A5%E4%BD%9C%E3%80%82

• Dotclear Docker镜像可在https://hub.docker.com/r/jcpd/docker-dotclear%E6%88%96https://github.com/JcDenis/docker-dotclear/pkgs/container/docker-dotclear%E8%8E%B7%E5%8F%96
• Dotclear Docker源码可在https://github.com/JcDenis/docker-dotclear%E8%8E%B7%E5%8F%96
• Dotclear Docker帮助文档（法语）可在Doclear Watch Blog获取

3.1 标签

Docker镜像基于Alpine Linux操作系统、Nginx服务器和PHP-FPM语言构建。镜像标签由Dotclear版本或发布类型组成：

• x.x：特定的Dotclear版本（例如：2.31.1）
• latest：最新的稳定版Dotclear发布
• testing：Dotclear稳定分支的最新开发版本
• dev：Dotclear不稳定版（每日构建）

3.2 构建

克隆本仓库：

git clone https://github.com/JcDenis/docker-dotclear.git

从稳定渠道构建镜像，在Dockerfile路径下执行：

docker build -t dotclear:latest --build-arg CANAL=stable .

或从测试渠道构建镜像，在Dockerfile路径下执行：

docker build -t dotclear:testing --build-arg CANAL=testing .

或从不稳定渠道构建镜像，在Dockerfile路径下执行：

docker build -t dotclear:dev --build-arg CANAL=unstable .

构建支持：

• postgresql、mysql和sqlite数据库
• linux/386、linux/amd64、linux/arm/v6、linux/arm/v7、linux/arm64/v8、linux/ppc64le、linux/s390x（及更多）平台
• Docker容器健康检查

3.3 Docker使用

3.3.1 使用MariaDB数据库的docker-compose示例

创建并编辑docker-compose.yaml文件，内容如下：

services:
  # MYSQL数据库服务
  dc_db:
    image: mariadb:latest
    container_name: dotcleardb
    restart: unless-stopped
    command: --transaction-isolation=READ-COMMITTED --log-bin=binlog --binlog-format=ROW
    volumes:
      - dc_db:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: dotclear_root
      MYSQL_DATABASE: dotclear_db
      MYSQL_USER: dotclear_user
      MYSQL_PASSWORD: dotclear_pwd
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      start_period: 10s
      interval: 10s
      timeout: 5s
      retries: 3

  # PHP-FPM服务
  dc_app:
    image: jcpd/docker-dotclear:latest
    container_name: dotclearphp
    restart: unless-stopped
    volumes:
      - dc_app:/var/www/dotclear
    ports:
      - 80:80
    depends_on:
      dc_db: # MYSQL数据库服务
        condition: service_healthy # 等待数据库就绪
    environment:
      # 这些变量仅用于首次安装，详见inc/config.php
      DC_DBDRIVER: mysqlimb4 # MYSQL完整UTF-8支持
      DC_DBHOST: dc_db # MYSQL数据库服务名
      DC_DBNAME: dotclear_db # 对应MYSQL_DATABASE
      DC_DBUSER: dotclear_user # 对应MYSQL_USER
      DC_DBPASSWORD: dotclear_pwd # 对应MYSQL_PASSWORD
      DC_DBPREFIX: dc_ # 数据库表前缀
      DC_ADMINMAILFROM: *** # Dotclear发件***

volumes:
  dc_app: # NGINX（dotclear）卷
  dc_db: # MYSQL（数据库）卷

• 你必须将数据库用户和密码替换为其他安全值。

然后执行：

docker-compose up -d

Dotclear现在可在服务器的http://localhost/访问。首次运行时，Dotclear会执行安装过程并要求创建第一个用户。首次运行需等待容器下载并安装所需版本的Dotclear，这可能需要一些时间...

3.3.2 使用SQLite数据库的单容器docker-compose示例

创建并编辑docker-compose.yaml文件，内容如下：

services:
  dotclear:
    image: jcpd/docker-dotclear:latest
    container_name: dotclear
    restart: unless-stopped
    volumes:
      - ./dotclear:/var/www/dotclear
    ports:
      - 80:80
    environment:
      DC_DBDRIVER: sqlite
      DC_DBNAME: \var\www\dotclear\sqlite.db
      DC_ADMINMAILFROM: ***

然后执行：

docker-compose up -d

3.3.3 不使用docker compose的直接docker run命令

简单docker命令示例：

docker run -d --name dotclear -p 80:80 -v dotclear:/var/www/dotclear -e DC_DBDRIVER=sqlite -e DC_DBNAME=/var/www/dotclear/sqlite.db -e DC_ADMINMAILFROM=*** jcpd/docker-dotclear:latest

SQLite数据库将存储在\var\www\dotclear文件夹中

3.4 博客配置

3.4.1 子文件夹标准配置

这些镜像使用Dotclear的PATH INFO模式URL重写。默认情况下，URL和路径会由自定义插件自动修正。博客URL格式如下：

• http://localhost/default/
• http://localhost/blog2/
• ...

博客管理界面可通过http://localhost/admin访问。

在此配置下创建新博客时，必须在博客URL设置中使用带尾斜杠的_blog_id_，例如http://localhost/blog_id/

Web服务器配置

要自定义子文件夹的Web服务器配置，编辑：

/var/www/dotclear/app/servers/subfolder.conf

原始内容如下：

server {
    server_name localhost;
    include /etc/nginx/snippets/snippets_subfolder.conf;
    include /etc/nginx/snippets/snippets_common.conf;
}

3.4.2 子域名标准配置

这些镜像使用Dotclear的PATH INFO模式URL重写。默认情况下，URL和路径会由自定义插件自动修正。博客URL格式如下：

• [***]
• [***]
• ...

博客管理界面可通过[***]

在此配置下创建新博客时，必须在博客URL设置中使用_blog_id_作为子域名，例如[***]

Web服务器配置

要自定义子域名的Web服务器配置，编辑：

/var/www/dotclear/app/servers/subdomain.conf

原始内容如下：

server {
    server_name ~^(?<dc_blog_id>\w*?)?\.?(\w+\.\w+)$;
    if ($dc_blog_id = '') {
            set $dc_blog_id default;
    }
    if ($dc_blog_id = 'blog') {
            set $dc_blog_id default;
    }
    include /etc/nginx/snippets/snippets_subdomain.conf;
    include /etc/nginx/snippets/snippets_common.conf;
}

3.4.3 非标准配置

设置nginx服务器配置（见下文）：

• 根据需求调整_/var/www/dotclear/servers/*.conf_

然后配置博客：

• 访问管理界面[***]
• 左侧菜单_博客设置_
• 面板_高级参数_
• 设置_博客URL_为[***]
• 设置_URL扫描方式_为"PATH_INFO"

然后修复博客的public_path和public_url：

• 访问管理界面[***]
• 左侧菜单_about:config_
• 面板_系统_
• 设置_public_path_为博客公共目录在系统上的实际路径
• 设置_public_url_为博客公共目录的URL

3.5 目录结构

镜像的默认根路径为__/var/www/dotclear__，包含以下子文件夹：

• app：Dotclear应用程序文件
• blogs：博客公共目录
• cache：Dotclear模板缓存
• plugins：第三方插件目录
• servers：Nginx服务器配置
• themes：Dotclear主题目录
• var：Dotclear变量目录

3.6 升级

要将Dotclear升级到新版本，建议拉取最新镜像并重启Docker容器：

docker pull jcpd/docker-dotclear:latest && docker compose up -d

或使用Dotclear内置更新系统，但主题不会被更新。

4. 待办事项

• 添加更好的缓存管理（来自其他容器或Dotclear容器）。
• 添加邮件支持。

5. 安全

• Nginx主进程以root身份运行，并将uid/gid设置为www用户
• PHP-FPM主进程以root身份运行，并将uid/gid设置为www用户
• Docker镜像入口点以root身份运行，最后将运行用户切换为www
• Dotclear应用程序文件的所有者设置为www用户

安全报告详见https://github.com/JcDenis/docker-dotclear/blob/master//SECURITY.md%E6%88%96%E5%9C%A8GitHub%E4%BB%93%E5%BA%93%E6%8F%90%E4%BA%A4%E5%B7%A5%E5%8D%95%E3%80%82

6. 贡献

本镜像是开源项目。如果你想贡献，请阅读https://github.com/JcDenis/docker-dotclear/blob/master//CONTRIBUTING.md%E3%80%82%E4%BD%A0%E5%8F%AF%E4%BB%A5%E6%8F%90%E4%BA%A4%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%EF%BC%8C%E6%88%96%E4%BD%BF%E7%94%A8%E4%BB%BB%E4%BD%95%E4%BD%A0%E5%96%9C%E6%AC%A2%E7%9A%84%E6%96%B9%E5%BC%8F%E3%80%82

7. 许可证

涉及多种许可证，从仓库文件到最终Docker镜像中使用的软件：

7.1 DOCKER-DOTCLEAR仓库文件

docker-dotclear仓库中的所有文件均采用AGPL-3许可证，版权所有(c) Jean-Christian Paul Denis。

版权所有(c) Jean-Christian Paul Denis
AGPL-v3 <[***]>
本程序是自由软件：你可以根据GNU Affero通用公共许可证（第三版或更高版本）的条款重新分发和/或修改它。
本程序的分发旨在希望它有用，但不提供任何明示或暗示的担保，包括但不限于适销性和特定用途适用性的担保。有关更多详情，请参见GNU Affero通用公共许可证。
你应该已经收到了GNU Affero通用公共许可证的副本。如果没有，请参见<[***]>。

7.2 ALPINE LINUX

最终Docker镜像中的Alpine Linux操作系统采用MIT许可证，版权所有(c) 2019 Natanael Copa。

7.3 NGINX

最终Docker镜像中的NGINX Web服务器采用2条款BSD类许可证，版权所有(c) 2002-2021 Igor Sysoev，2011-2024 Nginx, Inc.。

7.4 PHP

最终Docker镜像中的PHP超文本预处理器采用PHP License v3.01许可证，版权所有(c) PHP Group。

7.5 DOTCLEAR

最终Docker镜像中的Dotclear软件采用AGPL-v3许可证，版权所有(c) Olivier Meunier & Association Dotclear。