litespeedtech/openlitespeed

OpenLiteSpeed WordPress Docker容器

https://github.com/litespeedtech/ols-dockerfiles/workflows/docker-build/badge.svg](https://github.com/litespeedtech/ols-dockerfiles/actions/new) https://github.com/litespeedtech/ls-cloud-image/graphs/contributors []([***]

基于Ubuntu 24.04 Linux，安装轻量级WordPress容器，可选择OpenLiteSpeed Edge或稳定版本。

前提条件

1. 安装Docker
2. 安装Docker Compose

配置

编辑.env文件以更新演示站点域名、默认MySQL用户及密码。如需更新默认OpenLiteSpeed和PHP版本，可查看https://hub.docker.com/repository/docker/litespeedtech/openlitespeed/tags%E3%80%82

安装

克隆此仓库或将仓库文件复制到新文件夹：

git clone https://github.com/litespeedtech/ols-docker-env.git

打开终端，cd到保存docker-compose.yml的文件夹，运行：

docker compose up

注意：如需运行单个Web服务器容器，请参阅此处的AMD64/ARM64使用方法。

组件

Docker镜像会在系统上安装以下软件包：

数据结构

克隆的项目结构：

bash
├── acme
├── bin
│   └── container
├── data
│   └── db
├── logs
│   ├── access.log
│   ├── error.log
│   ├── lsrestart.log
│   └── stderr.log
├── lsws
│   ├── admin-conf
│   └── conf
├── sites
│   └── localhost
├── LICENSE
├── README.md
└── docker-compose.yml

• acme：包含所有从Let's Encrypt获取的证书
• bin：包含多个CLI脚本，用于添加/删除虚拟主机、安装应用、升级等操作
• data：存储MySQL数据库
• logs：包含所有Web服务器日志和虚拟主机访问日志
• lsws：包含所有Web服务器配置文件
• sites：包含文档根目录（WordPress应用将安装于此）

使用方法

启动容器

使用up或start方法启动容器：

docker compose up

可使用守护进程模式运行：

docker compose up -d

容器现已构建并运行。

停止容器

docker compose stop

删除容器

如需停止并删除所有容器，使用down命令：

docker compose down

设置WebAdmin密码

强烈建议立即设置个人密码：

bash bin/webadmin.sh my_password

启动演示站点

运行以下命令后，可通过配置的域名访问WordPress安装页面。默认域名为http://localhost：

bash bin/demosite.sh

创建域名和虚拟主机

bash bin/domain.sh [-A, --add] example.com

删除域名和虚拟主机

bash bin/domain.sh [-D, --del] example.com

创建数据库

可自动生成用户名、密码和数据库名，或手动指定。自动生成命令：

bash bin/database.sh [-D, --domain] example.com

手动指定（将user_name、my_password、database_name替换为自定义值）：

bash bin/database.sh [-D, --domain] example.com [-U, --user] USER_NAME [-P, --password] MY_PASS [-DB, --database] DATABASE_NAME

安装WordPress站点

安装前需先运行database.sh脚本为域名预配置wp-config文件，然后执行：

./bin/appinstall.sh [-A, --app] wordpress [-D, --domain] example.com

连接Redis

进入WordPress > LiteSpeed Cache插件 > 缓存 > 对象，选择Redis方法，并在“主机”字段输入redis。

安装ACME

首次使用需运行ACME安装命令：

带邮件通知：

./bin/acme.sh [-I, --install] [-E, --email] EMAIL_ADDR

不带邮件通知：

./bin/acme.sh [-I, --install] [-NE, --no-email]

应用Let's Encrypt证书

使用根域名执行以下命令，将自动检查并应用包含www和不包含www的证书：

./bin/acme.sh [-D, --domain] example.com

其他参数：

• [-r, --renew]：使用-D或--domain参数为特定域名续期，如需强制续期，添加-f参数。
• [-R, --renew-all]：为所有域名续期，如需强制续期，添加-f参数。
• [-f, -F, --force]：强制续期特定域名或所有域名。
• [-v, --revoke]：吊销域名证书。
• [-V, --remove]：移除域名。

使用MKcert进行本地开发SSL

对于本地开发域名（.test、.local、.dev等），可使用mkcert生成受信任的SSL证书，避免警告。

安装MKcert

首次安装：

bash
bash bin/mkcert.sh --install

生成本地SSL证书

在本地环境添加域名后，生成SSL证书：

bash
bash bin/mkcert.sh [-D, --domain] example.test

注意：将为开发域名创建带有SSL配置的dockerLocal模板。

此时可通过HTTPS访问域名，如https://example.test，证书受信任。

移除本地SSL证书

移除SSL证书并恢复为HTTP：

bash
bash bin/mkcert.sh [-R, --remove] [-D, --domain] example.test

此操作将从dockerLocal模板中移除域名，并移回标准docker模板。

更新Web服务器

将Web服务器升级到最新稳定版本：

bash bin/webadmin.sh [-U, --upgrade]

应用OWASP ModSecurity

启用Web服务器的OWASP mod_secure：

bash bin/webadmin.sh [-M, --mod-secure] enable

禁用Web服务器的OWASP mod_secure：

bash bin/webadmin.sh [-M, --mod-secure] disable

访问数据库

安装后，可通过访问http://127.0.0.1:8080或https://127.0.0.1:8443使用phpMyAdmin访问数据库。默认用户名为root，密码为.env文件中配置的值。

自定义

如需通过添加包（如lsphp83-pspell）自定义镜像，可通过Dockerfile扩展：

1. 在主项目下创建custom文件夹及custom/Dockerfile文件。
2. 在Dockerfile中添加示例代码：

FROM litespeedtech/openlitespeed:latest
RUN apt-get update && apt-get install lsphp83-pspell -y

3. 在docker-compose.yml的“image: litespeedtech”下添加build: ./custom，如下：

  litespeed:
    image: litespeedtech/openlitespeed:${OLS_VERSION}-${PHP_VERSION}
    build: ./custom

4. 构建并启动：

docker compose up --build

支持与反馈

如使用OpenLiteSpeed Docker后仍有问题，可通过以下方式获取帮助：

• 加入GoLiteSpeed Slack社区参与实时讨论
• 在OpenLiteSpeed论坛发布问题获取社区支持
• 在https://github.com/litespeedtech/ols-docker-env/issues%E9%A1%B9%E7%9B%AE%E6%8A%A5%E5%91%8A%E9%97%AE%E9%A2%98

欢迎提交Pull请求