OpenList 是一个支持多种存储的文件列表程序，是社区驱动的 AList 分支，旨在防御基于信任的开源攻击。本教程将介绍多种安装方式，您可以根据自己的需求选择合适的方法。
脚本安装
这是最简单的安装方式，适合 Linux 系统用户。
系统要求
Linux 系统（使用 systemd）
root 权限
已安装 curl 和 tar
安装步骤
curl -fsSL https://res.oplist.org/script/v4.sh > install-openlist-v4.sh && sudo bash install-openlist-v4.sh按照界面提示选择选项 1 进行安装。安装完成后，可以使用 openlist或 openlist-manager命令管理服务。
手动安装
适合喜欢完全控制安装过程的用户。
下载二进制文件
从 下载页面选择适合您系统的版本。
Linux/macOS 安装
tar -zxvf openlist-xxxx.tar.gz
chmod +x openlist
./openlist serverWindows 安装
Expand-Archive .\openlist-xxxx.zip
.\openlist.exe server设置守护进程
Linux systemd 服务
创建 /usr/lib/systemd/system/openlist.service：
[Unit]
Description=openlist
After=network.target
[Service]
Type=simple
WorkingDirectory=path_openlist
ExecStart=path_openlist/openlist server
Restart=on-failure
[Install]
WantedBy=multi-user.targetDocker 安装
适合容器化环境部署。
基本 Docker 运行
docker run -d --restart=unless-stopped \
-v /etc/openlist:/opt/openlist/data \
-p 5244:5244 \
-e UMASK=022 \
--name="openlist" \
openlistteam/openlist:latestDocker Compose
创建 docker-compose.yml：
services:
openlist:
image: 'openlistteam/openlist:latest'
container_name: openlist
volumes:
- './data:/opt/openlist/data'
ports:
- '5244:5244'
environment:
- UMASK=022
restart: unless-stopped运行：
docker compose up -d1Panel 安装
适合使用 1Panel 面板的用户。
步骤
安装 1Panel（如果尚未安装）
登录 1Panel，进入应用商店
搜索 "openlist" 并点击安装
配置参数：
版本号：选择最新稳定版
WebUI 端口：默认 5244
S3 端口：默认 5246
时区：建议设置为 Asia/Shanghai
高级设置：务必勾选"端口外部访问"
TrueNAS 安装
适合 TrueNAS 用户。
步骤
使用"自定义应用"功能
配置镜像：
openlistteam/openlist:latest设置环境变量：
UMASK=022配置存储卷：挂载路径
/opt/openlist/data设置端口映射：容器端口 5244 映射到主机端口
点击安装并等待完成
桌面版安装
适合桌面用户，提供图形界面管理。
系统要求
Windows 10+、macOS 10.15+ 或 Linux (Ubuntu 18.04+)
下载安装
从 GitHub Releases下载对应系统的安装包。
Windows: 运行 .exe安装程序
macOS: 打开 .dmg并拖拽到应用程序
Linux: 使用包管理器安装 .deb或 .rpm包
PaaS 平台安装
以 ClawCloud 为例。
关键配置
镜像：
openlistteam/openlist:latest-lite容器端口：5244
持久卷挂载路径：
/opt/openlist/data启用外部访问
源码编译安装
适合开发者和需要自定义功能的用户。
环境准备
# Windows
scoop install git nodejs-lts pnpm go mingw-winlibs
# Linux/macOS
sudo apt install git curl build-essential # Debian/Ubuntu
brew install node@22 go # macOS构建步骤
克隆前端仓库并构建
克隆主仓库并复制前端文件
使用 Go 编译后端
二进制文件安装
直接从发布页面下载预编译的二进制文件。
选择标准
根据您的操作系统和架构选择合适的版本：
Linux: 选择对应的架构（amd64、arm64 等）
Windows: 选择 .zip 文件
macOS: 选择 Darwin 版本
反向代理配置
安装完成后，建议配置反向代理以提高安全性。
Nginx 配置
location / {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_redirect off;
proxy_pass http://127.0.0.1:5244;
client_max_body_size 20000m;
}Caddy 配置
example.com {
reverse_proxy 127.0.0.1:5244
}获取管理员密码
首次安装后，需要获取或设置管理员密码。
Docker 环境
# 随机生成密码
docker exec -it openlist ./openlist admin random
# 手动设置密码
docker exec -it openlist ./openlist admin set 你的新密码二进制安装
./openlist admin random常见问题
服务无法启动：检查端口是否被占用，确保有足够的权限
忘记密码：使用
admin random命令重新生成权限问题：确保数据目录有正确的读写权限
总结
OpenList 提供了多种安装方式，从简单的脚本安装到高级的源码编译，适合不同技术水平的用户。建议新手从脚本安装或 Docker 安装开始，有经验的用户可以选择手动安装或源码编译。
安装完成后，别忘了配置反向代理和设置强密码，以确保服务的安全性。
更多详细信息和更新，请参考 OpenList 官方文档。