jcpd/docker-dotclear Docker Image Overview

jcpd/docker-dotclear

用于开源网络发布软件Dotclear的Docker镜像，基于Alpine Linux、Nginx和PHP-FPM，提供多种标签版本，支持快速部署个人博客或网站，适用于不同技术水平用户的网络内容发布需求。

3 收藏0 次下载

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

中文简介版本下载

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

README

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

!稳定镜像构建 !测试镜像构建 !不稳定镜像构建

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 [***] && docker-compose up -d

2. 什么是Dotclear

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

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

=> [***]

3. 什么是docker-dotclear

本仓库包含在Docker环境中构建或运行Dotclear的所有功能。它主要基于darknao的工作。

Dotclear Docker镜像可在Docker Hub或Github registry获取
Dotclear Docker源码可在Github仓库获取
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 [***]

从稳定渠道构建镜像，在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/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用户

安全报告详见SECURITY文件或在GitHub仓库提交工单。

6. 贡献

本镜像是开源项目。如果你想贡献，请阅读CONTRIBUTING文件。你可以提交拉取请求，或使用任何你喜欢的方式。

7. 许可证

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

7.1 DOCKER-DOTCLEAR仓库文件

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