litespeedtech/litespeed

LiteSpeed WordPress / Magento Docker容器

https://github.com/litespeedtech/lsws-dockerfiles/workflows/docker-build/badge.svg](https://hub.docker.com/r/litespeedtech/litespeed) []([***]

基于Ubuntu 24.04 Linux，安装带有LiteSpeed稳定版本的轻量级WordPress容器。

前提条件

1. 安装Docker
2. 安装Docker Compose

配置

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

安装

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

• 用于WordPress：

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

• 用于Magento/WordPress：

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

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

docker compose up

注意：如仅需运行单个Web服务器容器，请查看https://github.com/litespeedtech/lsws-dockerfiles#usage%E3%80%82

组件

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

容器将构建并运行。

注意：容器会自动应用15天试用许可证。如需延长试用或应用自有许可证，请联系LiteSpeed，许可证起价$0。

停止容器

docker compose stop

删除容器

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

docker compose down

设置WebAdmin密码

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

bash bin/webadmin.sh my_password

启动演示站点

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

bash bin/demosite.sh -W

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

bash bin/demosite.sh -M

创建域名和虚拟主机

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

如未应用证书，服务器可能会显示SSL证书警告，可忽略。

删除域名和虚拟主机

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

安装Magento站点

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

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

带示例数据的Magento：

./bin/appinstall.sh [-A, --app] Magento [-D, --domain] example.com [-S, --sample]

安装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]：移除域名

更新Web服务器

如需升级Web服务器至最新稳定版，运行：

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

应用OWASP ModSecurity

启用Web服务器的OWASP mod_secure：

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

禁用OWASP mod_secure：

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

如服务器显示ModSecurity警告，可能是部分规则不受支持，可忽略。

应用LSWS许可证

使用命令应用许可证：

bash bin/webadmin.sh [-S, --serial] YOUR_SERIAL

应用试用许可证：

bash bin/webadmin.sh [-S, --serial] TRIAL

访问数据库

安装后，可通过访问[***]

自定义

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

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

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

3. 在docker-compose.yml的litespeed服务下添加build: ./custom，如下所示：

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

4. 构建并启动：

docker compose up --build

支持与反馈

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

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

欢迎提交Pull请求