gpt4free 容器部署指南：在树莓派上用 Docker 免费跑 LLM

gpt4free 容器部署指南在树莓派上用 Docker 免费跑 LLM【免费下载链接】gpt4freeThe official gpt4free repository | various collection of powerful language models | opus 4.6 gpt 5.3 kimi 2.5 deepseek v3.2 gemini 3项目地址: https://gitcode.com/GitHub_Trending/gp/gpt4freeGPT4Freeg4f是一个聚合了多家大模型接口的开源项目用 Docker 跑起来后它会提供一个 Web 聊天界面和一套 OpenAI 兼容的 REST API树莓派这类 ARM 设备完全可以作为它的承载主机。本指南面向想在弱算力设备上部署 gpt4free 的用户用仓库自带的 slim 镜像完成从零到可用的全过程全程不需要改一行源码。先确认你的设备适不适合跑这一章帮你判断手头设备能不能上、选哪套镜像。g4f 官方说明支持 x86_64 和 arm64 两种架构slim 镜像同时提供这两种构建见 README。树莓派 4/5 这类 arm64 设备、AWS Graviton、Apple Silicon Mac 都在支持范围内。维度完整镜像hlohaus789/g4f精简镜像hlohaus789/g4f:latest-slim体积较大小适合树莓派启动行为开箱即用启动时可自动更新 g4f 包、按需补装依赖额外功能含 VNC 桌面端口7900供部分 provider 登录用核心 Web GUI API持久化目录har_and_cookies、generated_media同左树莓派资源有限优先选 slim 镜像。内存建议 2GB 起步4GB 更稳用 64 位系统Raspbian 11 及以上才能跑 arm64 镜像。⚠️ 早期版本在 aarch64 上出现过Illegal instruction (core dumped)崩溃项目已通过依赖降级机制修复详情见 aarch64 兼容性说明。如果你的设备是树莓派 1/ZeroARMv6/v7 老指令集不在 arm64 支持范围内需换 x86 设备或较新的树莓派。拉取 slim 镜像并启动容器这一章解决服务怎么跑起来。整个流程就三条命令。在项目根目录即 docker-compose-slim.yml 所在目录执行mkdir -p har_and_cookies generated_media docker pull hlohaus789/g4f:latest-slim docker run -d --name g4f-slim \ -p 8080:8080 \ -v ${PWD}/har_and_cookies:/app/har_and_cookies \ -v ${PWD}/generated_media:/app/generated_media \ hlohaus789/g4f:latest-slim三条命令分别的作用建好两个持久化目录存放登录凭据与生成的图片/媒体、拉取精简镜像、后台启动容器并把两个目录挂载进容器。不想手动敲命令的话可以直接用仓库提供的 compose 配置docker-compose -f docker-compose-slim.yml up -d它会把服务命名为g4f-slim映射8080端口GUI 与 API 共用并把同样的两个目录挂进来。镜像里内置的 start.sh 会执行python -m g4f --port 8080 --debug --reload容器一启动服务就起来无需额外干预。如果你希望从仓库源码自己构建而不是拉现成镜像slim 版的构建脚本是 docker/Dockerfile-slim它基于python:slim-bookworm并会在构建时直接从上游仓库同步最新代码。5 分钟验收服务是否就绪这一章给出可量化的验收标准跑完这三步才算部署成功。打开 Web 界面浏览器访问http://树莓派IP:8080/chat/能看到聊天页面即表示 Web GUI 正常。打一次 API 请求在服务所在机器的终端发一条 OpenAI 兼容的POST /v1/chat/completions请求模型名可从界面里选如gpt-3.5-turbo收到 JSON 回复就说明 API 链路通了。看日志无致命错误执行docker logs g4f-slim滚动到底部应能看到服务监听 8080 的信息没有反复出现的 Traceback。⚠️ 部分 provider 依赖curl_cffi在 aarch64 上会自动回退到aiohttp实现个别模型响应可能变慢属正常降级而非故障见 兼容性文档。排错手册树莓派上最常遇到的三类问题这一章覆盖启动失败、访问不通、内存不足三个高频场景。容器起不来或反复重启。先docker logs g4f-slim看日志。树莓派上最常见的历史问题是 ARM 架构不匹配导致的 illegal instruction新版已修复如果仍出现升级到最新系统镜像、确认uname -m输出是aarch64再试。浏览器打不开 8080 端口。按顺序排查本机先试http://localhost:8080排除远程访问问题再用docker ps确认容器在运行、端口映射显示0.0.0.0:8080-8080/tcp远程不通时检查树莓派的防火墙与同网段可达性。运行中卡死或响应极慢。多半是内存不足。树莓派默认 swap 较小可临时调大 swap 分区同时关闭其他占内存的服务。slim 镜像本身比较克制但浏览器自动化类 providernodriver、webview在 ARM 上可能不可用遇到相关报错直接换用普通 HTTP 类 provider 即可。下一步到这里你的树莓派已经是一台常驻的免费 LLM 网关任何支持 OpenAI API 格式的工具都能直连它。下一步建议把一个常用工具如 Open WebUI 或任意支持自定义 base_url 的客户端指向http://树莓派IP:8080/v1开始日常使用更多接口参数与 provider 列表直接查 README 与 etc/examples/ 里的示例脚本。【免费下载链接】gpt4freeThe official gpt4free repository | various collection of powerful language models | opus 4.6 gpt 5.3 kimi 2.5 deepseek v3.2 gemini 3项目地址: https://gitcode.com/GitHub_Trending/gp/gpt4free创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考