OpenList 安装与配置指南

当然可以！以下是基于你的问题和解决方案整理的详细教程，帮助其他用户在类似环境下顺利安装和配置 OpenList。

# OpenList 安装与配置指南
    官方文档：https://doc.oplist.org.cn/
    方法：查看 Web API 接口（100% 有效）
    OpenList 的公开 API 一定会返回版本号。执行以下命令：
    curl -s http://127.0.0.1:5244/api/public/settings | grep -o '"version":"[^"]*"'

本指南将详细介绍如何在阿里云 ECS 实例上通过宝塔面板使用 Docker Compose 部署 OpenList，并解决过程中遇到的各种权限问题。

## 环境准备

- **操作系统**: CentOS 7/8 或其他兼容 Linux 发行版
- **阿里云 ECS**
- **宝塔面板**: 已安装并配置好
- **Docker 和 Docker Compose**: 已安装并配置好

## 步骤一：创建并配置项目目录

1. 登录到你的 ECS 实例：
   ```bash
   ssh root@your_server_ip

2. 创建 OpenList 项目目录：

   mkdir -p /opt/openlist/data

3. 初步设置目录权限（后续会根据实际挂载点调整）：

   chown -R 1001:1001 /opt/openlist/data
   chmod -R 755 /opt/openlist/data

步骤二：编写 docker-compose.yml 文件

编辑 /opt/openlist/docker-compose.yml 文件，确保内容如下：

version: '3.8'
services:
  openlist:
    image: openlistteam/openlist:latest
    container_name: openlist
    user: "1001:1001"
    volumes:
      - /opt/openlist/data:/opt/openlist/data
    ports:
      - "5244:5244"
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

注意：此处我们使用绝对路径以避免宝塔重定向相对路径的问题。

步骤三：通过宝塔面板部署 OpenList

1. 打开宝塔面板，进入 Docker → Compose
2. 添加新项目，选择 /opt/openlist/docker-compose.yml
3. 确认无误后点击 添加

步骤四：检查容器挂载情况及修复权限问题

检查挂载点

执行以下命令查看 OpenList 容器的实际挂载情况：

docker inspect openlist | grep -A 10 -B 5 "Source\|Destination"

若发现挂载点为 /www/server/panel/data/compose/openlist/data 而非预期的 /opt/openlist/data，则需要修正权限为此实际挂载点。

设置正确权限

1. 停止当前容器：

   docker stop openlist

2. 设置宝塔实际使用的目录权限：

   chown -R 1001:1001 /www/server/panel/data/compose/openlist/data
   chmod -R 755 /www/server/panel/data/compose/openlist/data

3. 验证权限设置：

   ls -ld /www/server/panel/data/compose/openlist/data
   stat /www/server/panel/data/compose/openlist/data

步骤五：重启容器并验证安装

1. 在宝塔面板中重启 OpenList 项目。

2. 查看日志输出：

   docker logs -f openlist

   应看到类似如下的成功信息：

   Successfully created the admin user and the initial password is: qovYcQhJ

3. 访问 OpenList Web 界面：

   http://your_server_ip:5244

安全建议

• 修改初始管理员密码。
• 限制公网访问端口，仅允许特定 IP 地址访问。
• 使用 Nginx 反向代理 + HTTPS 加密传输。

希望这份指南能帮助你顺利完成 OpenList 的安装与配置。如果有任何疑问或需要进一步的帮助，请随时联系支持团队。

这个指南涵盖了从环境准备、项目创建、文件编写、权限设置到最终部署验证的所有步骤，并且针对具体问题给出了明确的解决方案。希望对你有所帮助！