拾书盘

宝塔一体包安装

本指引适用于拾书盘现有宝塔 Linux AMD64 安装包。拾书盘的交付与授权流程独立于另外两款产品，不要使用影视盘或矩阵盘的包、配置与授权替代。

1. 准备运行环境

使用 Linux x86_64 服务器，在宝塔中准备 Nginx、MySQL、Docker 与 Docker Compose v2。为拾书盘创建独立数据库与数据库用户，并配置正式域名。

2. 上传安装包

解压后进入包含 install.sh、docker-compose.yml、.env.example 和 images/ 的交付目录，执行：

docker --version
docker compose version
chmod +x install.sh
./install.sh

首次执行会生成 .env 并提示填写配置，然后退出。这是正常准备步骤，不代表服务已启动。

3. 填写配置并重新安装

在服务器的 .env 中配置正式站点地址、独立数据库名、数据库账号、后台强密码和会话密钥。保持凭据文件仅管理员可读；不要把其他产品的数据库或密钥复制过来。完成后再次执行：

./install.sh
docker compose ps

安装器校验并加载包内镜像、启动服务，预期出现启动成功提示。程序默认监听本机 127.0.0.1:18088；用 Nginx 反向代理并配置 HTTPS 后再对外访问。

4. 完成首次使用

访问自己的 /admin/，完成该交付版本的软件授权。先人工录入少量书籍、分类与资源链接，核对前台展示，再接入外部工具和开放 API。

5. 维护与排错

备份数据库、上传目录、运行目录和原凭据加密密钥。启动未成功时查看容器状态和日志：

docker compose ps
docker compose logs --tail=200

检查数据库连接、站点域名和本机端口；不要在未核对版本兼容性的情况下覆盖运行目录。更新请按拾书盘交付包内的 UPGRADE.md 与本产品后台说明执行。