开始前的准备

1. 安装必要环境

# Linux用户执行以下命令：
curl -fsSL https://get.docker.com | bash -s docker
sudo systemctl enable --now docker
sudo curl -L "https://github.com/docker/compose/releases/download/v2.23.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

2. 创建项目目录

mkdir openwebui && cd openwebui  # 新建并进入项目文件夹
touch docker-compose.yml         # 创建配置文件

docker-compose.yml 完整配置（带逐行注释）

version: '3.8'  # 使用较新的Compose版本格式

services:
  openwebui:
    image: ghcr.io/open-webui/open-webui:main  # 官方镜像源
    container_name: openwebui_app              # 自定义容器名称
    restart: unless-stopped                    # 自动重启策略（除非手动停止）
    volumes:
      - ./openwebui_data:/app/backend/data       # 持久化数据存储（重要！）
    healthcheck:                              # 健康监测（智能重启保障）
      test: ["CMD", "curl", "-f", "http://localhost:8080"]
      interval: 30s    # 检查间隔
      timeout: 5s      # 超时判定
      retries: 3       # 重试次数
  npm-app:
	image: 'jc21/nginx-proxy-manager:latest'
	container_name: npm-app
	restart: unless-stopped
	ports:
	  - '80:80'
	  - '81:81'
	  - '443:443'
	volumes:
	  - ./npm-data:/data
	  - ./letsencrypt:/etc/letsencrypt

3. 一键启动所有容器

docker-compose up -d  # -d参数代表后台运行

打开你配置好的域名进入前端页面

点击左下角设置，添加自定义模型

在1处添加第三方服务商提供的api地址，2处填写api key