dragontek/octobercms

支持的标签及对应Dockerfile链接

• 7.1-fpm (https://github.com/Dragontek/octobercms/blob/master/7.1/fpm/Dockerfile)
• 7.1-apache (https://github.com/Dragontek/octobercms/blob/master/7.1/apache/Dockerfile)
• 7.2-fpm (https://github.com/Dragontek/octobercms/blob/master/7.2/fpm/Dockerfile)
• 7.2apache, latest (https://github.com/Dragontek/octobercms/blob/master/7.2/apache/Dockerfile)

关于本仓库

此自动化构建基于官方WordPress自动化构建镜像，支持类似标签。

快速启动

若想快速上手，可直接运行该镜像无需关联其他容器：

$ docker run --name some-october -p 8080:80 -d dragontek/octobercms

该命令会启动容器并初始化本地SQLite数据库，访问http://localhost:8080%E5%8D%B3%E5%8F%AF%E8%BF%9B%E5%85%A5%E7%BD%91%E7%AB%99%E3%80%82%E5%90%8E%E5%8F%B0%E9%BB%98%E8%AE%A4%E7%94%A8%E6%88%B7%E5%90%8D%E5%92%8C%E5%AF%86%E7%A0%81%E5%9D%87%E4%B8%BA'admin'%E3%80%82

OctoberCMS提供后端直接修改文件的功能，对于主题开发等任务可能已足够。完成后可使用主题导出功能，但需注意不要删除容器，否则会丢失更改。

镜像还暴露/var/www/html目录，若需使用本地编辑器，可将该目录挂载到本地：

$ docker run --name some-october -p 8080:80 -v $(pwd):/var/www/html -d dragontek/octobercms

此方式会将完整网站复制到当前目录，更适合插件开发等场景。

数据库支持

上述示例使用本地SQLite，但生产环境建议使用MySQL/MariaDB或Postgres。镜像支持关联这两种数据库引擎：

$ docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=example -d mariadb
$ docker run --name some-october --link some-mysql:mysql -d dragontek/octobercms

或

$ docker run --name some-postgres -e POSTGRES_PASSWORD=example -d postgres
$ docker run --name some-october --link some-postgres:postgres -d dragontek/octobercms

这些命令会启动数据库、关联容器并配置OctoberCMS使用相应数据库。

通过docker-compose部署

基础示例docker-compose.yml

version: '2'
services:
  web:
    image: "docker.xuanyuan.run/dragontek/octobercms"
    ports:
     - "8080:80"
  mysql:
    image: "docker.xuanyuan.run/mariadb"
    environment:
     - MYSQL_ROOT_PASSWORD=example
  memcached:
    image: "docker.xuanyuan.run/memcached"

高级示例docker-compose.yml

version: '2'
services:
  web:
    image: "docker.xuanyuan.run/dragontek/octobercms"
    ports:
     - "8080:80"
    depends_on:
     - postgres
     - memcached
     - redis
    environment:
     - GIT_HOSTS=gitlab.com
     - GIT_THEMES=git@gitlab.com:path/mytheme.git
     - OCTOBER_CMS_ACTIVE_THEME=mytheme
     - OCTOBER_PLUGINS=October.Drivers;RainLab.GoogleAnalytics;
     - OCTOBER_DB_DRIVER=pgsql
     - OCTOBER_DB_HOST=postgres
     - OCTOBER_DB_PASSWORD=example
     - OCTOBER_CACHE_DEFAULT=memcached
     - OCTOBER_SESSION_DRIVER=redis
    volumes:
     - ~/.ssh/id_rsa:/root/.ssh/id_rsa
  postgres:
    image: "docker.xuanyuan.run/postgres"
    environment:
     - POSTGRES_PASSWORD=example
  memcached:
    image: "docker.xuanyuan.run/memcached"
  redis:
    image: "docker.xuanyuan.run/redis"

数据库环境变量

以下环境变量用于配置OctoberCMS实例：

• -e OCTOBER_DB_DRIVER=...（默认根据关联数据库容器选择合适驱动，外部数据库需指定为'mysql'或'pgsql'，可设为'none'表示无数据库）
• -e OCTOBER_DB_HOST=...（默认关联数据库容器的IP）
• -e OCTOBER_DB_PASSWORD=...（默认关联数据库容器用户的密码）
• -e OCTOBER_DB_NAME=...（默认october_cms）

主题与插件

可通过以下环境变量从市场安装主题和/或插件：

• -e OCTOBER_THEMES=...（默认null）
• -e OCTOBER_PLUGINS=...（默认null） 多个主题或插件用分号分隔（例如：-e OCTOBER_PLUGINS="RainLab.Blog;RainLab.GoogleAnalytics"）

Git主题与插件

可通过以下环境变量从Git仓库安装主题和/或插件：

• -e GIT_HOSTS=...（默认null，用于将Git服务器添加到/root/.ssh/known_hosts，仅SSH需要）
• -e GIT_THEMES=...（默认null）
• -e GIT_PLUGINS=...（默认null） 多个主题或插件用分号分隔（例如：-e GIT_THEMES="git@gitlab.com:path/repo.git"）

若使用私有仓库，需将私钥映射到容器（例如：-v ~/.ssh/id_rsa:/root/.ssh/id_rsa），或使用仓库提供商的个人访问令牌通过HTTPS访问（例如：-e GIT_THEMES="https://username:token@gitlab.com:path/repo.git"）。

注意：插件会根据仓库路径确定命名空间（例如git@gitlab.com:mycompany/blog.git会克隆到/plugins/mycompany/blog）。

其他环境变量

大部分配置可通过环境变量设置，格式为OCTOBER_+配置文件名+属性名（驼峰式属性用下划线分隔）。以下是常用配置：

APP设置

• -e OCTOBER_APP_DEBUG=...（默认false）
• -e OCTOBER_APP_URL=...（默认'http://localhost'）
• -e OCTOBER_APP_TIMEZONE=...（默认'UTC'）
• -e OCTOBER_APP_LOCALE=...（默认'en'）
• -e OCTOBER_APP_KEY=...（默认随机生成32位密钥）
• -e OCTOBER_APP_CIPHER=...（默认'AES-256-CBC'）
• -e OCTOBER_APP_LOG=...（默认'single'）

CMS设置

• -e OCTOBER_CMS_EDGE_UPDATES=...（默认false）
• -e OCTOBER_CMS_ACTIVE_THEME=...（默认'demo'）
• -e OCTOBER_CMS_BACKEND_URI=...（默认'backend'）
• -e OCTOBER_CMS_DISABLE_CORE_UPDATES=...（默认false）
• -e OCTOBER_CMS_ENABLE_ROUTES_CACHE=...（默认false）
• -e OCTOBER_CMS_URL_CACHE_TTL=...（默认10）
• -e OCTOBER_CMS_PARSED_PAGE_CACHE_TTL=...（默认10）
• -e OCTOBER_CMS_ENABLE_ASSET_CACHE=...（默认false）
• -e OCTOBER_CMS_ENABLE_ASSET_MINIFY=...（默认null）
• -e OCTOBER_CMS_STORAGE_UPLOADS_DISK=...（默认'local'）
• -e OCTOBER_CMS_STORAGE_UPLOADS_PATH=...（默认'/storage/app/uploads'）
• -e OCTOBER_CMS_STORAGE_UPLOADS_FOLDER=...（默认'uploads'）
• -e OCTOBER_CMS_STORAGE_MEDIA_DISK=...（默认'local'）
• -e OCTOBER_CMS_STORAGE_MEDIA_PATH=...（默认'/storage/app/media'）
• -e OCTOBER_CMS_STORAGE_MEDIA_FOLDER=...（默认'media'）
• -e OCTOBER_CMS_CONVERT_LINE_ENDINGS=...（默认false）
• -e OCTOBER_CMS_LINK_POLICY=...（默认'detect'）
• -e OCTOBER_CMS_ENABLE_CSRF_PROTECTION=...（默认false）

文件系统设置

• -e OCTOBER_FILESYSTEMS_DEFAULT=...（默认'local'）
• -e OCTOBER_FILESYSTEMS_CLOUD=...（默认's3'）
• -e OCTOBER_FILESYSTEMS_DISKS_S3_KEY=...（默认'your-key'）
• -e OCTOBER_FILESYSTEMS_DISKS_S3_SECRET=...（默认'your-secret'）
• -e OCTOBER_FILESYSTEMS_DISKS_S3_REGION=...（默认'your-region'）
• -e OCTOBER_FILESYSTEMS_DISKS_S3_BUCKET=...（默认'your-bucket'）
• -e OCTOBER_FILESYSTEMS_DISKS_RACKSPACE_KEY=...（默认'your-key'）
• -e OCTOBER_FILESYSTEMS_DISKS_RACKSPACE_USERNAME=...（默认'your-username'）
• -e OCTOBER_FILESYSTEMS_DISKS_RACKSPACE_CONTAINER=...（默认'your-container'）

邮件设置

• -e OCTOBER_MAIL_DRIVER=...（默认'mail'）
• -e OCTOBER_MAIL_HOST=...（默认'smtp.mailgun.org'）
• -e OCTOBER_MAIL_PORT=...（默认587）
• -e OCTOBER_MAIL_FROM_ADDRESS=...（默认'noreply@domain.tld'）
• -e OCTOBER_MAIL_FROM_NAME=...（默认'OctoberCMS'）
• -e OCTOBER_MAIL_ENCRYPTION=...（默认'tls'）
• -e OCTOBER_MAIL_USERNAME=...（默认null）
• -e OCTOBER_MAIL_PASSWORD=...（默认null）
• -e OCTOBER_MAIL_PRETEND=...（默认false）

服务设置

• -e OCTOBER_SERVICES_MAILGUN_DOMAIN=...（默认''）
• -e OCTOBER_SERVICES_MAILGUN_SECRET=...（默认''）
• -e OCTOBER_SERVICES_MANDRILL_SECRET=...（默认''）
• -e OCTOBER_SERVICES_SES_KEY=...（默认''）
• -e OCTOBER_SERVICES_SES_SECRET=...（默认''）
• -e OCTOBER_SERVICES_SES_REGION=...（默认'us-east-1'）
• -e OCTOBER_SERVICES_STRIPE_MODEL=...（默认'User'）
• -e OCTOBER_SERVICES_STRIPE_SECRET=...（默认''）

会话设置

• -e OCTOBER_SESSION_DRIVER=...（默认'file'）
• -e OCTOBER_SESSION_LIFETIME=...（默认120）
• -e OCTOBER_SESSION_ENCRYPT=...（默认false）
• -e OCTOBER_SESSION_CONNECTION=...（默认null）
• -e OCTOBER_SESSION_TABLE=...（默认'sessions'）
• -e OCTOBER_SESSION_COOKIE=...（默认'october_session'）
• -e OCTOBER_SESSION_PATH=...（默认'/'）
• -e OCTOBER_SESSION_DOMAIN=...（默认null）
• -e OCTOBER_SESSION_SECURE=...（默认false）

说明

本镜像仍在持续开发中，计划支持更多环境变量以允许用户配置OctoberCMS实例的更多功能。如有其他需求，欢迎反馈。