image

环境与安装

系统要求

  • 操作系统 :Linux x86_64/ARM64(推荐 Ubuntu 22.04+ 或 CentOS 8+)
  • 依赖工具 :curl、systemd

一键部署

  • 默认路径安装 :执行官方脚本自动安装(默认路径 /opt/openlist):
    curl -fsSL https://docs.openlist.team/v3.sh | bash

  • 自定义路径安装 :如需自定义路径:
    bash v3.sh install /your/path

服务管理

  • 启动服务 :systemctl start openlist
  • 查看状态 :systemctl status openlist
  • 实时日志 :journalctl -u openlist -f

初始化密码

  • 进入安装目录 :cd /opt/openlist
  • 生成随机密码 :./openlist admin random
  • 指定密码设置 :./openlist admin set 123456

访问验证

  • 浏览器访问http://[服务器 IP]:5244
  • 默认端口修改 :若需修改默认端口 5244,可在安装路径下编辑 config.yaml

故障处理

  • 服务启动失败
    • 检查存储驱动冲突 :./openlist storage list # 列出驱动
    • 禁用问题驱动 :./openlist storage disable /problem_path # 禁用问题驱动

Docker 部署方案

docker run -d -p 5244:5244 -v /data:/opt/openlist/data openlist/openlist

注意事项

  • 本文基于 OpenList v3.3 编写,建议通过 ./openlist update 保持版本更新。
  • 部署完成后需配置防火墙开放 5244 端口。