Openlist部署教程

Tue, 08 Sep 2026 00:00:00 GMT

前置操作

#放行openlist端口5244
firewall-cmd --add-port=5244/tcp --permanent
#重启防火墙
firewall-cmd --reload
#查看防火墙放行端口
firewall-cmd --list-ports
#查看完整全部规则（端口 + 服务 + 网卡信息，排查首选）
firewall-cmd --list-all

1.手动安装

官网：Openlist

1.1下载Openlist

#使用curl下载Openlist
curl -L -O https://github.com/OpenListTeam/OpenList/releases/download/v4.2.5/openlist-linux-musl-amd64.tar.gz

#curl下载失败试试wget
wget https://github.com/OpenListTeam/OpenList/releases/download/v4.2.5/openlist-linux-musl-amd64.tar.gz

1.2解压和安装

#解压下载的文件
tar -zxvf openlist-linux-musl-amd64.tar.gz

#给予特殊执行权限
chmod +x openlist

#将程序移动到系统目录
mv openlist /usr/bin/

#创建数据目录
mkdir -p /etc/openlist

1.3测试运行并获取密码

# 直接运行OpenList
openlist server --data /etc/openlist

配置文件：/etc/openlist/config.json

运行后你会看到类似这样的输出：
INFO[2026-08-21 13:40:35] reading config file: /usr/bin/data/config.json
INFO[2026-08-21 13:40:35] config file not exists, creating default config file
INFO[2026-08-21 13:40:35] load config from env with prefix: OPENLIST_
INFO[2026-08-21 13:40:35] total memory: 7904MB, available: 7336MB
INFO[2026-08-21 13:40:35] min free memory: 790MB
INFO[2026-08-21 13:40:35] max block limit: 64MB
INFO[2026-08-21 13:40:35] auto memory limit: 4MB
INFO[2026-08-21 13:40:35] init logrus...
#密码
Successfully created the admin user and the initial password is: kZGfUg3l
start HTTP server @ 0.0.0.0:5244

1.4创建系统服务(Openlist后台运行)

#创建服务配置文件
vi /etc/systemd/system/openlist.service

在文件中输入以下内容

[Unit]
Description=OpenList service
Wants=network.target
After=network.target network.service

[Service]
Type=simple
WorkingDirectory=/etc/openlist
ExecStart=/etc/openlist server
KillMode=process

[Install]
WantedBy=multi-user.target

启动并启用服务

# 重新加载systemd配置
systemctl daemon-reload
 
# 设置开机自启
systemctl enable openlist
 
# 立即启动服务
systemctl start openlist
 
# 检查服务状态
systemctl status openlist

● openlist.service - OpenList Service
     Loaded: loaded (/etc/systemd/system/openlist.service; enabled; preset: disabled)
     Active: active (running) since Fri 2026-08-21 09:35:18 CST; 4h 23min ago
   Main PID: 3004 (openlist)
      Tasks: 9 (limit: 50296)
     Memory: 26.8M (peak: 28.8M)
        CPU: 640ms
     CGroup: /system.slice/openlist.service
             └─3004 /usr/bin/openlist server --data /etc/openlist

8月 21 09:35:18 test systemd[1]: Started OpenList Service.
8月 21 09:35:18 test openlist[3004]: INFO[2026-08-21 09:35:18] reading config file: /etc/openlist/config.json
8月 21 09:35:18 test openlist[3004]: INFO[2026-08-21 09:35:18] load config from env with prefix: OPENLIST_
8月 21 09:35:18 test openlist[3004]: INFO[2026-08-21 09:35:18] total memory: 7904MB, available: 7363MB
8月 21 09:35:18 test openlist[3004]: INFO[2026-08-21 09:35:18] min free memory: 790MB
8月 21 09:35:18 test openlist[3004]: INFO[2026-08-21 09:35:18] max block limit: 64MB
8月 21 09:35:18 test openlist[3004]: INFO[2026-08-21 09:35:18] auto memory limit: 4MB
8月 21 09:35:18 test openlist[3004]: INFO[2026-08-21 09:35:18] init logrus...
8月 21 09:35:18 test openlist[3004]: start HTTP server @ 0.0.0.0:5244

如果状态显示"active (running)"，说明服务启动成功

如果查看状态出现

systemctl status openlist

● openlist.service - OpenList Service
     Loaded: loaded (/etc/systemd/system/openlist.service; enabled; preset: disabled)
     Active: activating (auto-restart) (Result: exit-code) since Fri 2026-08-21 09:31:02 CST; 1s ago
    Process: 1437 ExecStart=/usr/bin/openlist server --data /etc/openlist (code=exited, status=203/EXEC)
   Main PID: 1437 (code=exited, status=203/EXEC)
        CPU: 665us

解决办法：
	1.临时关闭SELinux
		setenforce 0
	2.恢复默认文件标签
		restorecon -v /usr/bin/openlist
	该命令会根据 /etc/selinux/targeted/contexts/files/file_contexts 中的规则恢复默认标签

1.5访问Openlist

浏览器访问：http://服务器地址:5244
用户名：admin
密码：第三步中获取的初始密码
登录后立即修改密码

2、一键脚本安装

curl -fsSL https://res.oplist.org/script/v4.sh > install-openlist-v4.sh && sudo bash install-openlist-v4.sh

欢迎使用 OpenList 管理脚本

基础功能：
1、安装 OpenList
2、更新 OpenList
3、卸载 OpenList
-------------------
服务管理：
4、查看状态
5、密码管理
6、启动 OpenList
7、停止 OpenList
8、重启 OpenList
-------------------
配置管理：
9、备份配置
10、恢复配置
-------------------
高级选项：
11、Docker 管理
12、定时更新
13、系统状态
14、关于
-------------------
0、退出脚本

请输入选项 [0-14]: 1
检查系统空间...
安装目录准备就绪：/opt/openlist
是否使用 GitHub 代理？（默认无代理）
代理地址必须为 https 开头，斜杠 / 结尾
例如：https://ghproxy.net/
请输入代理地址或直接按 Enter 继续:
使用默认 GitHub 地址进行下载

下载 OpenList ...
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
  0     0    0     0    0     0      0      0 --:--:--  0:00:01 --:--:--     0
  2 46.6M    2 1317k    0     0  56936      0  0:14:19  0:00:23  0:13:56 28794

┌────────────────────────────────────────────────────┐
│ OpenList 安装成功！                           │
│                                                    │
│ 版本信息：v4.2.5                              │
│                                                    │
│ 访问地址：                                    │
│   局域网：http://XXX.XXX.XXX.XXX:5244/         │
│   公网：  http://XXX.XXX.XXX.XXX:5244/           │
│ 配置文件：/opt/openlist/data/config.json      │
│                                                    │
│ 账号信息：                                    │
│ 默认账号：admin                               │
│ 初始密码：r4tUrEAl                            │
└────────────────────────────────────────────────────┘
命令行工具安装成功！

现在你可以使用以下命令：
1. openlist          - 快捷命令
2. openlist-manager  - 完整命令

启动服务中...
管理: 在任意目录输入 openlist 打开管理菜单

温馨提示：如果端口无法访问，请检查服务器安全组、防火墙和服务状态

3、使用docker安装

3.1安装docker(安装过docker可跳过)

3.1.1卸载旧版本(可选，干净系统可跳过)

dnf remove -y docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine

3.1.2安装依赖工具

dnf install -y dnf-plugins-core

3.1.3添加docker软件源

#添加仓库
dnf config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

# 替换源地址为阿里云
sed -i 's+download.docker.com+mirrors.aliyun.com/docker-ce+' /etc/yum.repos.d/docker-ce.repo

#更新 dnf 软件源的本地缓存
dnf makecache

3.1.4安装 Docker 全套（包含 docker‑compose 插件）

dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

3.1.5启动服务&设置开机自启

# 启动docker
sudo systemctl start docker

# 设置开机自启
sudo systemctl enable docker

# 查看状态
sudo systemctl status docker

3.1.6验证安装

# 查看 docker 版本

docker --version


#显示 docker 版本号
Docker version 29.7.2, build a7dcaa6


#查看 docker compose 版本
docker compose version

#显示 docker compose 版本号
Docker Compose version v5.5.0

3.1.7配置国内镜像加速(解决拉镜像慢)

编辑 /etc/docker/daemon.json

#在etc目录下创建docker目录
mkdir -p /etc/docker


#将加速源写入daemon.json文件
tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1ms.run"
  ],
  "log-driver":"json-file",
  "log-opts":{"max-size":"100m","max-file":"3"}
}
EOF

重载并重启 docker 生效：

# 重新加载systemd配置
systemctl daemon-reload

# 重启docker
systemctl restart docker

校验加速是否生效：

# 查看 Docker 系统全局信息
docker info
#输出内容往下看 Registry Mirrors 能看到上面配置的地址即成功
Client: Docker Engine - Community
 Version:    29.7.2
 Context:    default
 Debug Mode: false
 Plugins:
  buildx: Docker Buildx (Docker Inc.)
    Version:  v0.36.1
    Path:     /usr/libexec/docker/cli-plugins/docker-buildx
  compose: Docker Compose (Docker Inc.)
    Version:  v5.5.0
    Path:     /usr/libexec/docker/cli-plugins/docker-compose

Server:
 Containers: 0
  Running: 0
  Paused: 0
  Stopped: 0
 Images: 0
 Server Version: 29.7.2
 Storage Driver: overlayfs
  driver-type: io.containerd.snapshotter.v1
 Logging Driver: json-file
 Cgroup Driver: systemd
 Cgroup Version: 2
 Plugins:
  Volume: local
  Network: bridge host ipvlan macvlan null overlay
  Log: awslogs fluentd gcplogs gelf journald json-file local splunk syslog
 CDI spec directories:
  /etc/cdi
  /var/run/cdi
 Swarm: inactive
 Runtimes: io.containerd.runc.v2 runc
 Default Runtime: runc
 Init Binary: docker-init
 containerd version: aad11006b869517fcd3009450b6f82da282e1a9b
 runc version: v1.4.3-0-gbb14dabe
 init version: de40ad0
 Security Options:
  seccomp
   Profile: builtin
  cgroupns
 Kernel Version: 5.14.0-687.10.1.el9_8.0.1.x86_64
 Operating System: Rocky Linux 9.8 (Blue Onyx)
 OSType: linux
 Architecture: x86_64
 CPUs: 4
 Total Memory: 7.72GiB
 Name: test
 ID: a4e9e10f-f157-4f20-9507-d4010ff321fd
 Docker Root Dir: /var/lib/docker
 Debug Mode: false
 Experimental: false
 Insecure Registries:
  ::1/128
  127.0.0.0/8
 Registry Mirrors:
  https://docker.m.daocloud.io/
  https://docker.1ms.run/
 Live Restore Enabled: false
 Firewall Backend: iptables+firewalld
  EnableUserlandProxy: true
  UserlandProxyPath: /usr/bin/docker-proxy

3.1.8免 sudo 执行 docker（可选，普通用户）

把你的用户加入 docker 组，不用每次敲 sudo

sudo usermod -aG docker $USER

[!WARNING] 需要重新登录 SSH 会话才生效

3.1.9常用命令速查

# 查看运行容器
docker ps
# 查看全部容器
docker ps -a
# 本地镜像列表
docker images
# 后台启动compose项目
docker compose up -d
# 停止删除compose容器
docker compose down
#停止docker容器
docker stop 容器名或容器id
#删除docker容器
docker rm 容器名或容器id

3.2使用docker安装openlist

安装好 Docker 后，执行以下命令：

[!CAUTION] 请注意：/etc/openlist 仅为默认映射的目录，您可以根据需要修改为其他目录。

[!TIP] 如果您希望使用当前用户运行和管理 OpenList 及其配置目录，请使用以下命令：

#在etc目录下创建openlist目录
mkdir -p /etc/openlist

#拉取openlist镜像并运行
docker run --user $(id -u):$(id -g) -d --restart=unless-stopped -v /etc/openlist:/opt/openlist/data -p 5244:5244 -e UMASK=022 --name="openlist" openlistteam/openlist:latest

[!TIP] 如果您希望使用 1001，即容器内置的默认 openlist 用户运行和管理 OpenList 及其配置目录，请使用以下命令：

chown -R 1001:1001 /etc/openlist

docker run -d --restart=unless-stopped -v /etc/openlist:/opt/openlist/data -p 5244:5244 -e UMASK=022 --name="openlist" openlistteam/openlist:latest

首次运行

docker logs openlist

你将在日志中看到密码

Successfully created the admin user and the initial password is: 6zlCeP5E

3.3使用docker compose安装

创建 docker-compose.yml 文件。

mkdir -p /opt/openlist
cd /opt/openlist
vim docker-compose.yml

写入以下内容，然后保存并退出：

# docker-compose.yml
services:
  openlist:
    image: 'openlistteam/openlist:latest'
    container_name: openlist
    user: '0:0' # Please replace `0:0` with the actual user ID and group ID you want to use to run OpenList.
    volumes:
      - './data:/opt/openlist/data'
    ports:
      - '5244:5244'
    environment:
      - UMASK=022
    restart: unless-stopped

3.4使用docker compose 一键部署Openlist+Meilisearch索引

为meilisearch生成密钥

openssl rand -hex 16

使用docker compose部署

services:
  openlist:
    image: 'openlistteam/openlist:latest'
    container_name: openlist
    user: '0:0' # Please replace `0:0` with the actual user ID and group ID you want to use to run OpenList.
    volumes:
      - './data:/opt/openlist/data'
    ports:
      - '5244:5244'
    environment:
      - UMASK=022
    networks:
      - openlist
    restart: unless-stopped
    
  meilisearch:
    image: getmeili/meilisearch:v1.53
    container_name: meilisearch
    ports:
      - '7700:7700'
    volumes:
      - /tmp/data/Docker/meilisearch/meili_data:/meili_data
    command: meilisearch --schedule-snapshot --snapshot-dir /meili_data/snapshots
    environment:
      - MEILI_MASTER_KEY=刚刚生成的密钥
    tty: true
    stdin_open: true
    networks:
      - openlist
    restart: unless-stopped

networks:
  openlist:
    driver: bridge

在openlist中设置使用meilisearch

如何在openlist设置meilisearch

首先你需要修改config.json,在这个示例中，它应该位于/tmp/data/Docker/OpenList/config.json。

修改下文的部分，填写meilisearch的ip地址与端口，以及你在MEILI_MASTER_KEY设置的密钥

  "meilisearch": {
    "host": "http://meilisearch:7700",
    "api_key": "your_master_key_here",
    "index": "openlist"
  },

接下来打开管理面板，点击索引，选择meilisearch，点击刷新，即可编制索引

3.5使用docker compose单部署Meilisearch索引

services:
  meilisearch:
    image: getmeili/meilisearch:v1.53
    container_name: meilisearch
    ports:
      - '7700:7700'
    volumes:
      - /tmp/data/Docker/meilisearch/meili_data:/meili_data
    command: meilisearch --schedule-snapshot --snapshot-dir /meili_data/snapshots
    environment:
      - MEILI_MASTER_KEY=密钥
    tty: true
    stdin_open: true
    networks:
      - openlist
    restart: unless-stopped

networks:
  openlist:
    driver: bridge

4、获取 / 重置管理员密码

OpenList 初始 admin 密码是随机生成的，不会是固定值。三种获取/重置方式：

Docker 环境

# 重新随机生成并打印密码
docker exec -it openlist ./openlist admin random

# 或手动设置一个强密码
docker exec -it openlist ./openlist admin set 你的强密码

二进制环境

cd /opt/openlist
./openlist admin random      # 重新生成随机密码（打印到终端）
./openlist admin set 你的强密码   # 直接设置指定密码

忘记密码时，用 admin random 重新生成即可；首次安装后请立即改密。

WorkBuddy安装教程

Tue, 08 Sep 2026 00:00:00 GMT

:::NOTE[WorkBuddy 是什么？] WorkBuddy 是腾讯推出的全场景 AI 办公智能体。你用大白话描述需求，它会像同事一样自己拆解任务、操作你电脑里的文件，并把成果（文档 / 表格 / PPT / 海报 / 代码）做出来交给你。与普通聊天 AI 最大的区别是：它不只是「会说」，而是「真动手干活」。无需翻墙、无需复杂配置，微信扫码即可使用，并带有免费额度。 :::

一、安装前准备（系统要求）

操作系统 Windows10或Windows11(64 位)。 Windows7/8/8.1 无法运行，请先升级系统。	架构主流 x64 电脑直接安装；官网也提供 Windows x64（兼容 ARM64）版本，适用于 Surface 等 ARM 设备。
磁盘空间安装包约 150–180 MB，安装后占用约 500 MB 以上，建议预留 1 GB。	网络与账号需联网下载；登录使用微信或手机号，建议提前准备好微信。

二、下载安装包

1、打开浏览器，在地址栏输入官方下载页：

https://www.workbuddy.cn/

官网直达

XiaoMai

Openlist部署教程

1.手动安装

1.1下载Openlist

1.2解压和安装

1.3测试运行并获取密码

1.4创建系统服务(Openlist后台运行)

1.5访问Openlist

2、一键脚本安装

3、使用docker安装

3.1安装docker(安装过docker可跳过)

3.2使用docker安装openlist

3.3使用docker compose安装

3.4使用docker compose 一键部署Openlist+Meilisearch索引

3.5使用docker compose单部署Meilisearch索引

4、获取 / 重置管理员密码

WorkBuddy安装教程

一、安装前准备（系统要求）

二、下载安装包

1、打开浏览器，在地址栏输入官方下载页：

2、官网会自动识别你的系统。在下载区域点击「下载 WorkBuddy」或 Windows 版本的下载按钮，页面会给出 `.exe` 安装包（Mac 则为 `.dmg`）

三、安装步骤（一路「下一步」即可）

1、找到安装包。下载完成后，在 Chrome 中按 Ctrl + J 打开下载记录；或在文件管理器的「下载」文件夹中找到名称含 `WorkBuddy`、后缀为 `.exe` 的文件。

2、运行安装程序。双击该 `.exe` 文件，等待几秒。电脑反应慢时不要连续双击，否则可能同时弹出多个安装窗口，一路下一步。

四、首次启动与登录

1、WorkBuddy 启动后，会进入登录界面。使用微信扫码或手机号登录即可。

2、微信扫码：打开手机微信扫描屏幕上的二维码，在手机上确认登录。

3、登录成功后即可进入主界面。提示：登录的账号后续与积分、用量绑定，请确认登录的账号无误。

XiaoMai

Openlist部署教程

1.手动安装

1.1下载Openlist

1.2解压和安装

1.3测试运行并获取密码

1.4创建系统服务(Openlist后台运行)

1.5访问Openlist

2、一键脚本安装

3、使用docker安装

3.1安装docker(安装过docker可跳过)

3.2使用docker安装openlist

3.3使用docker compose安装

3.4使用docker compose 一键部署Openlist+Meilisearch索引

3.5使用docker compose单部署Meilisearch索引

4、获取 / 重置管理员密码

WorkBuddy安装教程

一、安装前准备（系统要求）

二、下载安装包

1、打开浏览器，在地址栏输入官方下载页：

2、官网会自动识别你的系统。在下载区域点击「下载 WorkBuddy」或 Windows 版本的下载按钮，页面会给出 .exe 安装包（Mac 则为 .dmg）

三、安装步骤（一路「下一步」即可）

1、找到安装包。下载完成后，在 Chrome 中按 Ctrl + J 打开下载记录；或在文件管理器的「下载」文件夹中找到名称含 WorkBuddy、后缀为 .exe 的文件。

2、运行安装程序。双击该 .exe 文件，等待几秒。电脑反应慢时不要连续双击，否则可能同时弹出多个安装窗口，一路下一步。

四、首次启动与登录

1、WorkBuddy 启动后，会进入登录界面。使用微信扫码或手机号登录即可。

2、微信扫码：打开手机微信扫描屏幕上的二维码，在手机上确认登录。

3、登录成功后即可进入主界面。提示：登录的账号后续与积分、用量绑定，请确认登录的账号无误。

2、官网会自动识别你的系统。在下载区域点击「下载 WorkBuddy」或 Windows 版本的下载按钮，页面会给出 `.exe` 安装包（Mac 则为 `.dmg`）

1、找到安装包。下载完成后，在 Chrome 中按 Ctrl + J 打开下载记录；或在文件管理器的「下载」文件夹中找到名称含 `WorkBuddy`、后缀为 `.exe` 的文件。

2、运行安装程序。双击该 `.exe` 文件，等待几秒。电脑反应慢时不要连续双击，否则可能同时弹出多个安装窗口，一路下一步。