这篇文章就是专门给零基础同学准备的“部署说明书”，我会把自己实操过3遍的完整流程拆解开：从最开始的系统准备（比如更新系统、装必备工具），到容易踩坑的依赖配置（Python、Git、Docker这些关键组件怎么装才不会出错），再到Open-WebUI的获取方式（不管是源码拉取还是包管理安装都讲清楚），甚至配置文件里的端口、权限怎么设才合理，最后服务启动、设成开机自启、用浏览器测试访问，每一步都写得像“手把手教”。
最关键的是，我会把部署中90%的“坑”标出来——比如防火墙没开端口导致访问不了，端口被其他服务占用，权限不够启动失败这些常见问题，每个坑都附上具体怎么解决，不用你自己猜原因。跟着走完这些步骤，就算你之前没碰过Linux，也能在CentOS上稳稳跑起Open-WebUI，亲测有效。
你要是用systemd管理服务（这也是我比较推荐的方式，毕竟CentOS系统里用这个管理服务稳定又方便），设置开机自启特别简单，直接在终端里敲 systemctl enable open-webui 就行。这条命令的意思就是告诉系统：“下次开机的时候，记得把open-webui服务也一起启动起来”。不过光设置完还不够，最好验证一下有没有真的设置成功，免得重启后发现服务没起来白忙活。你可以再执行 systemctl is-enabled open-webui，如果输出是“enabled”，那就说明自启设置没问题了，下次服务器重启，服务会自己跑起来。
要是你是用Docker部署的Open-WebUI，那设置自启就得在启动容器的时候多加点参数。启动容器的命令里，记得加上 restart=always 这个参数，比如完整的命令可能是 docker run -d restart=always name open-webui -p 端口号:端口号 镜像名（这里的端口号和镜像名要换成你自己部署时用的）。这个参数的作用是告诉Docker：“不管容器是因为什么原因停了（包括服务器重启），都要自动把它拉起来”。设置完之后，也可以验证一下，执行 docker inspect format '{{.HostConfig.RestartPolicy.Name}}' open-webui，如果输出是“always”，就说明Docker的自启策略生效了，服务器重启后容器会自动启动，不用你手动操作。
CentOS 7和CentOS 8/9系统都能按照本文步骤部署Open-WebUI吗？
大部分步骤通用，但需注意系统版本差异：CentOS 7使用yum包管理器，CentOS 8/9默认使用dnf，部分依赖包名可能不同（如CentOS 8/9需安装python3-pip而非python-pip）。文中关键步骤已标注版本适配说明，按对应系统版本调整命令即可。
部署后启动Open-WebUI服务提示失败，应该从哪些方面排查？
优先检查三个方向：①查看服务日志（通常在/var/log/open-webui/或执行journalctl -u open-webui），日志会明确错误原因；②检查端口是否被占用（执行netstat -tuln | grep 端口号，替换为配置文件中的端口）；③确认配置文件权限，确保运行用户（如www-data）对配置文件和数据目录有读写权限。
配置完成后，本地浏览器无法访问Open-WebUI界面怎么办？
先排查基础网络：①服务器防火墙是否开放部署时设置的端口（执行firewall-cmd list-ports，未开放需添加规则：firewall-cmd add-port=端口号/tcp permanent并重启防火墙）；②确认访问地址格式正确（http://服务器IP:端口号，IP需为服务器公网IP或局域网IP，端口与配置文件一致）；③检查服务是否真的启动（执行systemctl status open-webui确保状态为active (running)）。
安装依赖时提示“无法找到包”或“版本不匹配”，如何解决？
首先执行yum update（CentOS 7）或dnf update（CentOS 8/9）更新软件源缓存；若仍提示“无法找到包”，可能需要添加EPEL源（执行yum install epel-release或dnf install epel-release）；版本不匹配时，可指定版本安装（如yum install python3.9），或通过官方仓库安装（如Docker可参考Docker官方CentOS安装文档）。
如何设置Open-WebUI服务在服务器重启后自动启动？
若通过systemd管理服务（本文推荐方式），执行systemctl enable open-webui即可设置开机自启；若使用Docker部署，可在启动容器时添加restart=always参数（如docker run -d restart=always name open-webui ...）。设置后可通过systemctl is-enabled open-webui（systemd方式）或docker inspect format '{{.HostConfig.RestartPolicy.Name}}' open-webui（Docker方式）验证是否生效。
