Ubuntu使用docker安装Open WebUI - 版本历史

2026年6月24日 (三) 19:38 Hovercool

2026-06-24T19:38:08Z

@@ 第53行： / 第53行： @@
        # - OPENAI_API_KEY=sk-你的密钥
        # 可选：如果你不想注册登录，开启单用户模式
        # - WEBUI_AUTH=False
@@ 第130行： / 第143行： @@
+}
 </source>

2026年6月23日 (二) 04:02 Hovercool

2026-06-23T04:02:23Z

←上一版本		2026年6月23日 (二) 04:02的版本
第121行：		第121行：
	# 防止某些极端情况下大 Token 导致 502 错误		# 防止某些极端情况下大 Token 导致 502 错误
	proxy_buffer_size 128k;		proxy_buffer_size 128k;
	proxy_buffers 4 256k;		proxy_buffers 4 256k; # 补上这两行，防止 Nginx 的数学计算报错
	proxy_busy_buffers_size 256k;		proxy_busy_buffers_size 256k; # 同步补上
	proxy_cache off;		proxy_cache off;
	chunked_transfer_encoding on;		chunked_transfer_encoding on;

2026年6月23日 (二) 03:49 Hovercool

2026-06-23T03:49:21Z

←上一版本		2026年6月23日 (二) 03:49的版本
第80行：		第80行：
	=== 5. 创建nginx配置文件 ===		=== 5. 创建nginx配置文件 ===
	<source lang="xml">		<source lang="xml">
			# 请确认 /etc/nginx/nginx.conf 中已包含，且位于所有 include 或 server 块的上方：
			# http {
			# map $http_upgrade $connection_upgrade {
			# default upgrade;
			# '' close;
			# }
			# # ... 其他配置
			# }

	server {		server {
	server_name ai.xx.xx;		server_name ai.xxx.com;

			# 上传文件大小限制（根据需要调整，例如 100M）
			client_max_body_size 100M;

			# 安全头（防止点击劫持、MIME 嗅探等）
			add_header X-Frame-Options "SAMEORIGIN" always;
			add_header X-Content-Type-Options "nosniff" always;
			add_header X-XSS-Protection "1; mode=block" always;
			add_header Referrer-Policy "strict-origin-when-cross-origin" always;

	location / {		location / {
	proxy_pass http://~~localhost~~:~~3000~~;		proxy_pass http://127.0.0.1:52060;
	proxy_set_header Host $host;		proxy_set_header Host $host;
	proxy_set_header X-Real-IP $remote_addr;		proxy_set_header X-Real-IP $remote_addr;
第94行：		第111行：
	proxy_http_version 1.1;		proxy_http_version 1.1;
	proxy_set_header Upgrade $http_upgrade;		proxy_set_header Upgrade $http_upgrade;
	proxy_set_header Connection ~~"upgrade"~~;		proxy_set_header Connection $connection_upgrade;
	~~proxy_read_timeout 86400;~~
	}

	~~listen 443 ssl;~~ # ~~managed by Certbot~~		# 长连接超时
	~~ssl_certificate /etc/letsencrypt/live/ai.xx.xx/fullchain.pem; # managed by Certbot~~		proxy_read_timeout 30m;
	~~ssl_certificate_key /etc/letsencrypt/live/ai.xx.xx/privkey.pem~~; ~~# managed by Certbot~~		proxy_send_timeout 10m;
	~~include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot~~
	~~ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot~~

	}
	~~server {~~
	~~if ($host = ai.xx.xx) {~~
	~~return 301 https://$host$request_uri~~;
	~~} # managed by Certbot~~

			# 缓冲设置（优化大文件传输）
			proxy_buffering off;
			# 防止某些极端情况下大 Token 导致 502 错误
			proxy_buffer_size 128k;
			proxy_buffers 4 256k;
			proxy_busy_buffers_size 256k;
			proxy_cache off;
			chunked_transfer_encoding on;
			}

	listen 80;		listen 80;
	~~server_name ai.xx.xx;~~
	~~return 404; # managed by Certbot~~
	}		}

	</source>		</source>

2026年6月22日 (一) 14:03 Hovercool

2026-06-22T14:03:37Z

←上一版本		2026年6月22日 (一) 14:03的版本
第57行：		第57行：
	# ...（端口、环境变量等）		# ...（端口、环境变量等）
	# Compose 原生支持，不需要任何额外参数		# Compose 原生支持，不需要任何额外参数
	mem_limit: ~~256m~~ # ~~硬上限 256MB~~		mem_limit: 512m # 硬内存上限
	cpus: '0.5' # 最多用半个核		cpus: '0.5' # 最多用半个核
	</source>		</source>

2026年6月22日 (一) 10:03 Hovercool

2026-06-22T10:03:47Z

←上一版本		2026年6月22日 (一) 10:03的版本
第79行：		第79行：

	=== 5. 创建nginx配置文件 ===		=== 5. 创建nginx配置文件 ===
			<source lang="xml">

	server {		server {
	server_name ai.xx.xx;		server_name ai.xx.xx;
第113行：		第115行：
	return 404; # managed by Certbot		return 404; # managed by Certbot
	}		}

			</source>

2026年6月22日 (一) 09:46 Hovercool

2026-06-22T09:46:47Z

←上一版本		2026年6月22日 (一) 09:46的版本
第77行：		第77行：

	</source>		</source>

			=== 5. 创建nginx配置文件 ===
			server {
			server_name ai.xx.xx;

			location / {
			proxy_pass http://localhost:3000;
			proxy_set_header Host $host;
			proxy_set_header X-Real-IP $remote_addr;
			proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
			proxy_set_header X-Forwarded-Proto $scheme;

			# WebSocket 支持
			proxy_http_version 1.1;
			proxy_set_header Upgrade $http_upgrade;
			proxy_set_header Connection "upgrade";
			proxy_read_timeout 86400;
			}

			listen 443 ssl; # managed by Certbot
			ssl_certificate /etc/letsencrypt/live/ai.xx.xx/fullchain.pem; # managed by Certbot
			ssl_certificate_key /etc/letsencrypt/live/ai.xx.xx/privkey.pem; # managed by Certbot
			include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
			ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot

			}
			server {
			if ($host = ai.xx.xx) {
			return 301 https://$host$request_uri;
			} # managed by Certbot


			listen 80;
			server_name ai.xx.xx;
			return 404; # managed by Certbot
			}

2026年6月22日 (一) 09:20 Hovercool

2026-06-22T09:20:18Z

←上一版本		2026年6月22日 (一) 09:20的版本
第1行：		第1行：


	~~docker pull ghcr.io/open-webui/open-webui:main~~

	=== 1. 确保Docker和Docker Compose已安装 ===		=== 1. 确保Docker和Docker Compose已安装 ===
第23行：		第20行：

	这个 ~/openwebui目录就是未来迁移时需要整体打包的目录。		这个 ~/openwebui目录就是未来迁移时需要整体打包的目录。
	== ~~二、创建docker~~-compose.yml ==		=== 3. 创建docker-compose.yml ===

	使用以下命令创建配置文件：		使用以下命令创建配置文件：
第37行：		第34行：

	<source lang="bash">		<source lang="bash">

	~~version: '3.8'~~

	services:		services:
	open-webui:		open-webui:
第46行：		第40行：
	restart: unless-stopped		restart: unless-stopped
	ports:		ports:
	- "~~52040~~:8080"		- "3000:8080" #服务器端口:docker内端口
	volumes:		volumes:
	- ./data:/app/backend/data		- ./data:/app/backend/data
第65行：		第59行：
	mem_limit: 256m # 硬上限 256MB		mem_limit: 256m # 硬上限 256MB
	cpus: '0.5' # 最多用半个核		cpus: '0.5' # 最多用半个核
			</source>

			=== 4. 下载镜像并启动 ===
			下载镜像：
			<source lang="bash">

			docker pull ghcr.io/open-webui/open-webui:main

			</source>

			<source lang="bash">
			启动（上一步其实可省略，启动时应该也会自动下载）：
			$ docker compose up -d
			[+] up 2/2
			✔ Network openwebui_default Created 0.2s
			✔ Container open-webui Started

	</source>		</source>

2026年6月22日 (一) 09:12 Hovercool

2026-06-22T09:12:50Z

新页面

docker pull ghcr.io/open-webui/open-webui:main

=== 1. 确保Docker和Docker Compose已安装 ===
检查Docker是否已安装
<source lang="bash">

docker --version
docker compose version

</source>

如果未安装，可以参考之前的教程先安装Docker。
=== 2. 创建Gitea工作目录 ===
创建一个干净的目录，所有Gitea相关文件都会放在这里
<source lang="bash">

mkdir -p ~/openwebui
cd ~/openwebui

</source>

这个 ~/openwebui目录就是未来迁移时需要整体打包的目录。
== 二、创建docker-compose.yml ==

使用以下命令创建配置文件：
<source lang="bash">

bash

nano docker-compose.yml

</source>

粘贴以下内容：

<source lang="bash">

version: '3.8'

services:
open-webui:
image: ghcr.io/open-webui/open-webui:main
container_name: open-webui
restart: unless-stopped
ports:
- "52040:8080"
volumes:
- ./data:/app/backend/data
# environment:
# --- 根据你的情况选择配置，不需要的可以删除或注释掉 ---

# 方案一：连接远程 Ollama 服务（推荐）
# - OLLAMA_BASE_URL=http://192.168.1.100:11434 # 替换为你的 Ollama 服务器 IP

# 方案二：使用 OpenAI 兼容 API（如 DeepSeek）
# - OPENAI_API_BASE_URL=https://api.deepseek.com/v1
# - OPENAI_API_KEY=sk-你的密钥

# 可选：如果你不想注册登录，开启单用户模式
# - WEBUI_AUTH=False
# ...（端口、环境变量等）
# Compose 原生支持，不需要任何额外参数
mem_limit: 256m # 硬上限 256MB
cpus: '0.5' # 最多用半个核

</source>