如何用 Docker 自托管 Hollama从零开始的部署与配置教程【免费下载链接】hollamaA minimal LLM chat app that runs entirely in your browser项目地址: https://gitcode.com/gh_mirrors/ho/hollamaHollama 是一款完全在浏览器中运行的轻量级 LLM 聊天应用支持 Ollama 和 OpenAI 服务器。通过 Docker 自托管 Hollama您可以在自己的服务器上搭建一个私有的 AI 聊天平台享受数据本地存储和多服务器连接的便利。本教程将带您完成从零开始的 Docker 部署全流程让您快速搭建属于自己的 AI 助手环境。 Hollama 自托管的核心优势Hollama 自托管为您带来以下独特价值数据隐私保护所有聊天数据存储在您的浏览器本地不经过第三方服务器多服务器支持同时连接多个 Ollama 和 OpenAI 实例跨平台访问通过浏览器即可访问无需安装客户端现代化界面支持 Markdown 渲染、语法高亮和数学公式显示主题切换提供浅色和深色两种主题模式 部署前的准备工作在开始 Docker 部署之前请确保您的系统满足以下要求系统要求Docker已安装并运行至少512MB可用内存Linux/macOS/Windows支持 WSL2操作系统网络要求开放的4173 端口可自定义如果需要连接远程 Ollama 服务器确保网络连通性 基础 Docker 部署步骤步骤一拉取 Hollama Docker 镜像打开终端执行以下命令拉取最新的 Hollama 镜像docker pull ghcr.io/fmaclen/hollama:latest步骤二运行 Hollama 容器使用最简单的命令启动 Hollama 服务docker run --rm -d -p 4173:4173 --name hollama ghcr.io/fmaclen/hollama:latest步骤三访问 Hollama 界面在浏览器中打开以下地址http://localhost:4173您将看到简洁现代的 Hollama 界面可以立即开始使用 AI 聊天功能。⚙️ 高级配置选项1. 自定义端口映射如果您希望使用不同的端口可以修改-p参数docker run --rm -d -p 8080:4173 --name hollama ghcr.io/fmaclen/hollama:latest2. 配置允许访问的域名当在反向代理或 Kubernetes 环境中部署时需要设置允许访问的域名docker run --rm -d -p 4173:4173 \ -e VITE_ALLOWED_HOSTSyour-domain.com,another-domain.com \ --name hollama ghcr.io/fmaclen/hollama:latest3. 持久化数据存储虽然 Hollama 默认将数据存储在浏览器本地但您可以配置容器持久化docker run --rm -d -p 4173:4173 \ -v /path/to/data:/app/data \ --name hollama ghcr.io/fmaclen/hollama:latest 连接 Ollama 服务器本地 Ollama 连接如果您的 Ollama 服务器运行在同一台机器上Hollama 会自动发现并连接。确保 Ollama 服务正在运行ollama serve远程 Ollama 连接对于远程 Ollama 服务器需要在 Ollama 端配置允许的源OLLAMA_ORIGINShttp://your-hollama-domain.com ollama serve在 Hollama 的设置界面中添加您的 Ollama 服务器地址即可开始使用。️ 生产环境部署建议使用 Docker Compose 编排虽然项目未提供官方的 docker-compose.yml 文件您可以创建自己的编排配置version: 3.8 services: hollama: image: ghcr.io/fmaclen/hollama:latest container_name: hollama ports: - 4173:4173 environment: - VITE_ALLOWED_HOSTSyour-domain.com restart: unless-stopped结合 Nginx 反向代理对于生产环境建议使用 Nginx 作为反向代理server { listen 80; server_name your-domain.com; location / { proxy_pass http://localhost:4173; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_set_header Host $host; proxy_cache_bypass $http_upgrade; } }使用 HTTPS 加密通过 Lets Encrypt 获取 SSL 证书确保通信安全# 使用 certbot 获取证书 sudo certbot --nginx -d your-domain.com 版本更新与维护更新到最新版本保持 Hollama 最新版本非常简单# 停止当前容器 docker stop hollama # 拉取最新镜像 docker pull ghcr.io/fmaclen/hollama:latest # 重新启动容器 docker run --rm -d -p 4173:4173 --name hollama ghcr.io/fmaclen/hollama:latest容器监控与管理查看容器运行状态# 查看容器状态 docker ps | grep hollama # 查看容器日志 docker logs hollama # 进入容器调试用 docker exec -it hollama sh 常见问题排查问题一无法访问 Hollama 界面解决方案检查防火墙设置确保 4173 端口已开放。问题二连接 Ollama 失败解决方案确认 Ollama 服务正在运行检查网络连通性验证 Ollama 的 OLLAMA_ORIGINS 配置问题三容器启动失败解决方案# 查看详细错误信息 docker logs hollama # 检查端口占用 netstat -tulpn | grep 4173问题四跨域访问错误解决方案正确配置 VITE_ALLOWED_HOSTS 环境变量。 性能优化建议资源限制配置为 Docker 容器设置合理的资源限制docker run --rm -d -p 4173:4173 \ --name hollama \ --memory512m \ --cpus1.0 \ ghcr.io/fmaclen/hollama:latest使用健康检查添加健康检查确保服务可用性healthcheck: test: [CMD, wget, --no-verbose, --tries1, --spider, http://localhost:4173] interval: 30s timeout: 10s retries: 3 最佳实践总结定期更新每月检查并更新到最新版本备份数据定期导出重要的聊天会话监控日志关注容器日志中的异常信息安全配置在生产环境中使用 HTTPS资源优化根据实际使用情况调整资源分配 扩展功能与自定义自定义主题样式Hollama 支持主题自定义您可以通过修改 CSS 变量来调整界面样式。相关配置文件位于src/app.pcss中。多语言支持Hollama 内置了多语言界面支持英语、中文、日语等多种语言。语言文件位于src/i18n/目录下。插件系统虽然 Hollama 本身是轻量级应用但您可以通过自定义开发扩展其功能。主要的功能模块位于src/lib/目录中。 开始您的 AI 聊天之旅通过本教程您已经掌握了Hollama Docker 自托管的完整流程。从基础部署到高级配置从问题排查到性能优化您现在可以自信地在自己的服务器上搭建一个安全、私密、功能丰富的 AI 聊天平台。立即开始您的自托管之旅享受完全掌控的 AI 对话体验【免费下载链接】hollamaA minimal LLM chat app that runs entirely in your browser项目地址: https://gitcode.com/gh_mirrors/ho/hollama创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考