1.1 环境要求#

• 服务器：Linux/Windows/macOS 均可，推荐 Linux

• 运行依赖：Docker & Docker Compose，容器部署首选，简单易维护

• 网络：服务器可正常访问公网，保证与 hi168 对象存储节点通信

• 浏览器：主流 Chrome、Edge、Firefox，用于访问 OpenList 后台与 hi168 云桌面

1.2 hi168 账号注册与实名#

• 访问 hi168 官方地址完成账号注册，新用户默认赠送 500GB 对象存储容量

• 完成实名认证后，存储空间升级至 1TB 永久免费，无基础限速限制

• 登录后进入 hi168 云桌面，后续所有存储相关参数均在此桌面内获取

1
# hi168 注册官网
2
https://www.hi168.com/

1.3 工具清单#

• hi168 已实名账号
• 部署 OpenList 的服务器，带 Docker 环境
• 文本编辑器，编写 docker-compose.yaml 配置文档
• 浏览器，管理后台操作、参数查看

2.1 创建 hi168 存储桶#

• 在 hi168 云桌面中，双击打开存储管理图标

• 点击界面中 + 新建存储桶 新建按钮，自定义存储桶名称，名称建议纯英文、小写，无特殊符号

• 确认创建，记录该存储桶名称，后续配置需填写

2.2 获取 S3 端点（Endpoint）#

• 打开⚙️齿轮按钮，找到挂载存储桶功能入口；

• 选择上一步创建的存储桶，系统会自动生成挂载命令，从命令中提取 Endpoint 端点地址 并复制保存

2.3 获取访问密钥（AK/SK）#

• 依旧在「挂载存储桶」页面，页面内会展示两组密钥

• 分别复制 访问密钥 ID（Access Key ID） 和 安全访问密钥（Secret Access Key）

重要提醒：密钥属于隐私凭证，请勿对外泄露，若密钥泄露可在 hi168 后台重置

3.1 Docker Compose 部署 OpenList#

推荐容器化部署，一键启停、配置持久化，步骤如下：

• 在服务器新建文件夹（如 openlist），进入该目录：

1
mkdir openlist && cd openlist

• 创建 docker-compose.yaml 配置文件，写入以下内容：

1
services:
2
  openlist:
3
    image: openlistteam/openlist:latest
4
    container_name: openlist
5
   user: 0:0
6
    environment:
7
      - UMASK=022
8
    volumes:
9
      - ./data:/opt/openlist/data  # 数据持久化目录
10
    ports:
11
      - 5244:5244  # OpenList Web 管理端口
12
    restart: unless-stopped  # 开机自启

• 执行命令启动容器：

1
docker-compose up -d

• 启动成功后，通过 服务器IP:5244 访问 OpenList Web 后台

3.2 登录 OpenList 后台#

• 浏览器访问 http://你的服务器IP:5244

• 默认账号：admin，初始密码可通过容器日志查看：

1
docker logs openlist

• 登录成功后，第一时间进入「设置-账号安全」修改默认密码，提升安全性

4.1 新增 S3 存储驱动#

• 在 OpenList 左侧导航栏点击 存储，点击右上角 添加 按钮

• 在存储类型下拉列表中，选择 S3（对象存储） 驱动

• 自定义「存储名称」，用于后台区分存储，如 hi168-对象存储

4.2 填写 hi168 专属 S3 参数#

按照前文获取的参数，依次填写核心配置项，参数释义及填写规则如下：

4.4 挂载存储#

• 保存配置后，返回存储列表，此时 hi168 S3 存储会显示为「已挂载」状态

• 点击左侧对应存储名称，即可进入 hi168 对象存储文件浏览页面

5.1 基础连接验证#

进入挂载目录后，若能正常展示存储桶内文件/空目录，说明连接配置正常；若提示连接失败，返回第4章节核对所有参数。

5.2 文件上传测试#

• 在 OpenList 文件页面点击上传，选择本地文件，单文件、多文件均可

• 等待上传完成，刷新页面查看文件是否存在于 hi168 存储桶中

• 建议测试不同大小文件，小文件、百 MB 级大文件，验证稳定性

5.3 文件下载与预览#

• 点击已上传的文件，可直接在线预览，图片、文档、视频等
• 点击下载按钮，测试公网下载速度，hi168 白天传输速度稳定，晚高峰略有波动

5.4 目录管理#

支持新建文件夹、重命名文件/目录、移动文件、删除文件等常规操作，操作逻辑与本地文件管理器一致