FreeBSD Podman 安装与 GPT4Free 容器部署指南服务器容器化环境搭建与 AI 对话平台部署完整手册服务器: 192.168.0.88 系统: FreeBSD 15.1-RELEASE-p1 日期: 2026-07-21一、项目概述本文档记录了在FreeBSD 15.1服务器上安装Podman容器引擎并通过容器部署GPT4Freeg4fAI 对话平台的完整过程。由于 FreeBSD 原生不支持 Docker 守护进程本项目采用 Podman 作为替代方案。Podman 是无守护进程的容器引擎在 FreeBSD 上有更好的兼容性。部署成果Podman 5.8.4 已成功安装GPT4Free 容器已正常运行可通过浏览器访问 AI 对话界面。二、服务器环境操作系统FreeBSD 15.1-RELEASE-p1架构amd64 (x86_64)IP 地址192.168.0.88SSH 用户trae包管理器pkg文件系统ZFS三、Podman 安装步骤1更新 pkg 仓库sudo pkg update -f2安装 Podman 及依赖sudo pkg install -y podman此命令会自动安装以下依赖包conmon- 容器监控工具containernetworking-plugins- 容器网络插件containers-common- 容器通用配置ocijail- FreeBSD 容器运行时3挂载 fdescfs必需Podman 的容器重启策略需要 fdescfs 文件系统支持sudo mount -t fdescfs fdesc /dev/fd # 永久生效添加到 /etc/fstab echo fdesc /dev/fd fdescfs rw 0 0 | sudo tee -a /etc/fstab4加载 PF 内核模块网络支持# 立即加载 sudo kldload pf # 永久加载重启生效 echo pf_loadYES | sudo tee -a /boot/loader.conf # 启用本地回环过滤 sudo sysctl net.pf.filter_local15配置 PF 防火墙容器网络 NATsudo cp /usr/local/etc/containers/pf.conf.sample /etc/pf.conf # 编辑 /etc/pf.conf确保包含以下行 # nat-anchor cni-rdr/* # rdr-anchor cni-rdr/* # anchor cni-rdr/* # 启用并启动 PF sudo sysrc pf_enableYES sudo service pf start6验证安装podman --version # 预期输出: podman version 5.8.4四、国内加速镜像配置由于服务器访问 Docker Hub 速度较慢配置国内镜像加速源可显著提升拉取速度。4.1 配置文件路径/usr/local/etc/containers/registries.conf4.2 配置内容unqualified-search-registries [docker.io] [[registry]] prefix docker.io location docker.io [[registry.mirror]] location docker.m.daocloud.io [[registry.mirror]] location hub-mirror.c.163.com [[registry.mirror]] location docker.1panel.live [[registry.mirror]] location dockerpull.org [[registry.mirror]] location dockerhub.icu [[registry.mirror]] location docker.rainbond.cc [[registry.mirror]] location hub.rat.dev加速源可用性说明经 2026 年 7 月实测DaoCloud和1Panel对基础镜像如 alpine加速效果最好。部分加速源对特定镜像如 GPT4Free有白名单限制实际拉取时会自动 fallback 到可用源。五、GPT4Free 容器部署5.1 创建数据目录mkdir -p /tmp/g4f_data/har_and_cookies /tmp/g4f_data/generated_media5.2 拉取镜像# 通过加速源拉取推荐 sudo podman pull --oslinux docker.1panel.live/hlohaus789/g4f:latest-slim # 或直接从 Docker Hub 拉取 sudo podman pull --oslinux docker.io/hlohaus789/g4f:latest-slim镜像大小约 670MB拉取时间取决于网络速度。5.3 启动容器sudo podman run -d --name g4f --oslinux \ -p 8088:8080 \ -v /tmp/g4f_data/har_and_cookies:/app/har_and_cookies \ -v /tmp/g4f_data/generated_media:/app/generated_media \ hlohaus789/g4f:latest-slim端口说明容器内部服务监听8080端口映射到宿主机的8088端口因为 8080 被其他进程占用。如需使用其他端口修改-p 宿主机端口:8080即可。5.4 验证容器状态sudo podman ps -a # 预期输出: # NAMES STATUS PORTS # g4f Up 15 seconds 0.0.0.0:8088-8080/tcp六、访问方式Web 聊天界面http://192.168.0.88:8088/chat/OpenAI 兼容 APIhttp://192.168.0.88:8088/v1API 文档 (Swagger)http://192.168.0.88:8088/docs七、常用命令速查7.1 容器管理命令说明sudo podman ps -a查看所有容器sudo podman logs -f g4f查看 GPT4Free 实时日志sudo podman stop g4f停止容器sudo podman start g4f启动容器sudo podman restart g4f重启容器sudo podman rm -f g4f删除容器sudo podman exec -it g4f sh进入容器内部7.2 镜像管理命令说明sudo podman images查看本地镜像sudo podman pull 镜像拉取镜像sudo podman rmi 镜像ID删除镜像sudo podman image prune -f清理未使用镜像7.3 运行 Linux 容器FreeBSD 上的 Podman 默认运行 FreeBSD 容器。如需运行 Linux 容器必须添加--oslinux参数# 运行 Linux 容器示例 sudo podman run --rm --oslinux alpine echo Hello from Linux! # 运行 Linux 容器并交互 sudo podman run -it --rm --oslinux alpine sh八、注意事项FreeBSD Podman 为实验性功能不建议用于生产环境。运行 Linux 容器需要添加--oslinux参数否则默认尝试运行 FreeBSD 容器。部分 Docker 镜像可能无法在 FreeBSD 上正常运行建议使用官方测试过的镜像。容器数据存储在/var/db/containersZFS或/tmp/g4f_dataGPT4Free 数据。如需开机自启容器可设置sudo sysrc podman_enableYES。GPT4Free 的提供商接口可能随时变动如遇问题请查看 GitHub 仓库 最新更新。九、故障排除9.1 镜像拉取失败# 检查网络连通性 fetch -o - http://docker.io 21 | head -5 # 尝试其他加速源 sudo podman pull docker.m.daocloud.io/library/alpine:latest sudo podman pull docker.1panel.live/library/alpine:latest9.2 容器无法启动端口被占用# 查看端口占用 sockstat -l4 | grep 8088 # 更换端口重新启动 sudo podman rm -f g4f sudo podman run -d --name g4f --oslinux -p 8090:8080 ...9.3 容器网络不通# 检查 PF 模块是否加载 kldstat | grep pf # 检查 PF 服务状态 sudo service pf status # 重新加载 PF 配置 sudo pfctl -f /etc/pf.conf9.4 GPT4Free 无法访问# 查看容器日志 sudo podman logs --tail 50 g4f # 测试本地访问 fetch -o - http://127.0.0.1:8088/chat/ 21 | head -10十、参考资源GPT4Free 官方仓库GitHub - xtekky/gpt4free: The official gpt4free repository | various collection of powerful language models | opus 4.6 gpt 5.3 kimi 2.5 deepseek v3.2 gemini 3 · GitHubGPT4Free 官方文档GPT4Free Documentation HubPodman 官方文档Getting Started with Podman | PodmanFreeBSD 容器 WikiMaking sure youre not a bot!FreeBSD Podman 安装与 GPT4Free 容器部署指南服务器: 192.168.0.88 | 文档生成日期: 2026-07-21
