如何用 Docker 自托管 Hollama：从零开始的部署与配置教程

【免费下载链接】hollama A minimal LLM chat app that runs entirely in your browser 项目地址: https://gitcode.com/gh_mirrors/ho/hollama

Hollama 是一款完全在浏览器中运行的轻量级 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:latest

2. 配置允许访问的域名

当在反向代理或 Kubernetes 环境中部署时，需要设置允许访问的域名：

docker run --rm -d -p 4173:4173 \
  -e VITE_ALLOWED_HOSTS='your-domain.com,another-domain.com' \
  --name hollama ghcr.io/fmaclen/hollama:latest

3. 持久化数据存储

虽然 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_ORIGINS=http://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_HOSTS=your-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 加密

通过 Let's 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 失败

解决方案：

1. 确认 Ollama 服务正在运行
2. 检查网络连通性
3. 验证 Ollama 的 OLLAMA_ORIGINS 配置

问题三：容器启动失败

解决方案：

# 查看详细错误信息
docker logs hollama

# 检查端口占用
netstat -tulpn | grep 4173

问题四：跨域访问错误

解决方案：正确配置 VITE_ALLOWED_HOSTS 环境变量。

📊 性能优化建议

资源限制配置

为 Docker 容器设置合理的资源限制：

docker run --rm -d -p 4173:4173 \
  --name hollama \
  --memory="512m" \
  --cpus="1.0" \
  ghcr.io/fmaclen/hollama:latest

使用健康检查

添加健康检查确保服务可用性：

healthcheck:
  test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:4173"]
  interval: 30s
  timeout: 10s
  retries: 3

🎯 最佳实践总结

1. 定期更新：每月检查并更新到最新版本
2. 备份数据：定期导出重要的聊天会话
3. 监控日志：关注容器日志中的异常信息
4. 安全配置：在生产环境中使用 HTTPS
5. 资源优化：根据实际使用情况调整资源分配

📈 扩展功能与自定义

自定义主题样式

Hollama 支持主题自定义，您可以通过修改 CSS 变量来调整界面样式。相关配置文件位于 src/app.pcss 中。

多语言支持

Hollama 内置了多语言界面，支持英语、中文、日语等多种语言。语言文件位于 src/i18n/ 目录下。

插件系统

虽然 Hollama 本身是轻量级应用，但您可以通过自定义开发扩展其功能。主要的功能模块位于 src/lib/ 目录中。

🏁 开始您的 AI 聊天之旅

通过本教程，您已经掌握了 Hollama Docker 自托管的完整流程。从基础部署到高级配置，从问题排查到性能优化，您现在可以自信地在自己的服务器上搭建一个安全、私密、功能丰富的 AI 聊天平台。

立即开始您的自托管之旅，享受完全掌控的 AI 对话体验！🚀

【免费下载链接】hollama A minimal LLM chat app that runs entirely in your browser 项目地址: https://gitcode.com/gh_mirrors/ho/hollama