From 53696eb590b5cab4578fe76a866e2cef18f23faa Mon Sep 17 00:00:00 2001 From: Wisp X Date: Thu, 5 Dec 2024 15:38:39 +0800 Subject: [PATCH] =?UTF-8?q?docker=E9=83=A8=E7=BD=B2=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/zh/guide/install.md | 75 +++++++++++++++++++++++++++++++---------- 1 file changed, 58 insertions(+), 17 deletions(-) diff --git a/src/zh/guide/install.md b/src/zh/guide/install.md index 97d1d3ad..3d928f27 100644 --- a/src/zh/guide/install.md +++ b/src/zh/guide/install.md @@ -163,7 +163,9 @@ sudo supervisorctl reread && sudo supervisorctl update && sudo supervisorctl sta ## Docker 安装 -### 下载源码 +### 准备工作 + +#### 下载源码 因 PHP 源码的特殊性,兰空图床不提供构建好的镜像,需要通过本地构建镜像,然后运行。 @@ -173,13 +175,13 @@ sudo supervisorctl reread && sudo supervisorctl update && sudo supervisorctl sta 以下命令都需要在目标服务器站点的根目录执行。 ::: -### 构建本地镜像 +#### 构建本地镜像 ```shell docker build -t lsky-pro-plus -f docker/Dockerfile . ``` -### 创建数据目录 +#### 创建数据目录 为了方便查看上传文件、缓存、日志、数据库等,这些通常需要映射到宿主机。 @@ -200,7 +202,45 @@ mkdir -vp data/{cache,logs,private,public,uploads} \ - `data/uploads` 自定义储存上传的图片 - `data/database.sqlite` 数据库文件 -### 启动并运行 +### docker + +#### 创建网络 + +```shell +docker network create app-network +``` + +#### 运行 + +将以下命令中的配置替换正确后执行。 + +```shell +docker run -d \ + --name lsky-pro-plus \ + --env APP_NAME="Lsky Pro+" \ + --env APP_URL="http://localhost" \ + --env APP_SERIAL_NO="your_serial_no" \ + --env APP_SECRET="your_secret" \ + --env ADMIN_USERNAME="admin" \ + --env ADMIN_EMAIL="admin@example.com" \ + --env ADMIN_PASSWORD="password" \ + -p 8080:80 \ + -v app-code:/var/www \ + -v ./data/logs:/var/www/storage/logs \ + -v ./data/cache:/var/www/storage/app/cache \ + -v ./data/public:/var/www/storage/app/public \ + -v ./data/uploads:/var/www/storage/app/uploads \ + -v ./data/database.sqlite:/var/www/database/database.sqlite \ + --network app-network \ + --restart unless-stopped \ + lsky-pro-plus +``` + +### docker-compose + +#### 运行 + +将以下命令中的配置替换正确后执行。 ```shell{4-6} APP_DATA="./data" \ @@ -215,8 +255,21 @@ ADMIN_PASSWORD="123456" \ docker-compose up -d ``` +### 参数解释: + +- `APP_DATA` 持久化数据储存位置,可以是绝对路径或相对路径 +- `APP_PORT` 宿主机运行端口,默认为 8080 +- `APP_NAME` 应用名称 +- `APP_URL` 站点 url +- `APP_SERIAL_NO` 许可证编号 +- `APP_SECRET` 许可证密钥 +- `ADMIN_USERNAME` 管理员用户名,只能包含英文字母、数字、中横线(-)或下划线(_) +- `ADMIN_EMAIL` 管理员邮箱 +- `ADMIN_PASSWORD` 管理员密码 + ::: warning 请务必正确填写配置后执行,否则会导致安装失败,如果安装失败,可能需要删除容器后重启执行运行步骤。 + ```shell docker stop lsky-pro-plus docker rm lsky-pro-plus @@ -228,19 +281,7 @@ docker rmi -f lsky-pro-plus ``` ::: -参数解释: - -- `APP_DATA` 持久化数据储存位置,可以是绝对路径或相对路径 -- `APP_PORT` 宿主机运行端口,默认为 8080 -- `APP_NAME` 应用名称 -- `APP_URL` 站点 url -- `APP_SERIAL_NO` 许可证编号 -- `APP_SECRET` 许可证密钥 -- `ADMIN_USERNAME` 管理员用户名,只能包含英文字母、数字、中横线(-)或下划线(_) -- `ADMIN_EMAIL` 管理员邮箱 -- `ADMIN_PASSWORD` 管理员密码 - -请务必填写正确后执行。执行以下命令查看服务运行日志,便于排查问题: +您还可以执行以下命令查看服务运行日志,便于排查问题: ```shell docker logs -f lsky-pro-plus