VPS 搭建 Hajimi 轮询

注意

你的服务器不能是国内的服务器，建议美国、新加坡、日本地区；

国内服务器搭建的轮询可能会因为网络问题导致无法连接。

如果你腾讯云、阿里云的境外服务器在以上地区，但是无法连接的话，这可能是因为你的服务器IP被 Google 封禁了。

注意

如果你的服务器没有安装 Docker 和 Docker Compose，可以先参考 VPS安装Docker 教程。

1. 切换到 root 账户

sudo -i

如果提示输入密码，就输入服务器密码，输入过程密码不会显示，这是正常的。输入完按回车。

如果本来就是 root 用户，则不会要求输入密码，不会返回任何内容。

② 创建 hajimi 文件夹

mkdir hajimi

你可以输入 ls 命令（小写的 LS），查看是否创建成功，成功的话，返回的内容会包含 hajimi

2. 创建 compose 文件

先创建文件

cd ~/hajimi && nano docker-compose.yaml

再复制以下代码并粘贴进去

services:
  hajimi-app:
    image: beijixingxing/hajimi:latest
    container_name: hajimi  # 固定容器名方便监控
    labels:
      - "com.centurylinklabs.watchtower.enable=true"  # 启用自动更新
    ports:
      - "7860:7860"  # 左边是外部端口（可改），右边是容器端口（别动）
    env_file:
      - .env  
    environment:
      - TZ=Asia/Shanghai # 中国时区
      - ENABLE_STORAGE=true #数据持久化
     # - HTTP_PROXY=http://host.docker.internal:7890  # 代理地址，请注意！无外网环境需要取消注释，添加自己的代理地址
     # - HTTPS_PROXY=https://host.docker.internal:7890  # 同上，保持一样就行，电脑部署推荐使用host.docker.internal
    volumes: # 持久化挂载，自动创建
      - ./settings:/hajimi/settings
    restart: unless-stopped # 自动重启，但手动停止后不再重启

  #  自动更新监控服务（默认每小时检查一次）
  watchtower:
    image: containrrr/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 必须的Docker连接配置
    environment:
      - TZ=Asia/Shanghai # 中国时区
      - WATCHTOWER_LABEL_ENABLE=true  # 只监控带更新标签的容器
      - WATCHTOWER_POLL_INTERVAL=3600  # 检查间隔秒数（3600=1小时）
      - WATCHTOWER_CLEANUP=true  # 更新后自动删除旧镜像
    command: --interval 3600  # 双重确认间隔时间
    restart: unless-stopped # 自动重启，但手动停止后不再重启

粘贴完了长这样。

然后按键盘上的快捷键 Ctrl + O （字母欧），下方出现 File Name to Write 后，再按回车保存

再按 Ctrl + X，退出编辑。

此时输入 ls （小写 LS），就可以查看到 docker-compose 文件了。

3. 创建.env 配置文件

先创建文件

cd ~/hajimi && nano .env

再复制以下代码并粘贴进去

（代码里高亮的地方，自己复制到其他地方，改好后再去粘贴）

• PASSWORD 后面的值，就是你轮询的密钥，在酒馆或者其他软件里，密钥就填这个
• GEMINI_API_KEYS 后面可以输入多个密钥，以 英文逗号 分隔开（也可以只放一个）(中文逗号必然无法使用)

注意

注意：除了高亮的两个内容外，其他的配置内容是我为你写好的推荐配置，如果需要详细的注释以修改其他配置，请参考（https://github.com/beijixingxing/hajimi/blob/main/wiki/docker/.env）

注意

若干你需要使用小手机（部分小手机要求密钥以sk-开头），你可以将PASSWORD 改成以sk-开头的密钥，例如 PASSWORD=sk-123

# 🌟 基础安全配置
# 访问密码，用于访问服务的身份验证
PASSWORD=123

# 用英文逗号分隔多个API KEY，可使用多个Gemini API密钥
GEMINI_API_KEYS=key1,key2,key3 

# 现在是自己用的推荐配置
TZ=Asia/Shanghai
MAX_REQUESTS_PER_MINUTE=30
MAX_REQUESTS_PER_DAY_PER_IP=600
FAKE_STREAMING=true
API_KEY_DAILY_LIMIT=200
RANDOM_STRING=true
RANDOM_STRING_LENGTH=5
CONCURRENT_REQUESTS=1
INCREASE_CONCURRENT_ON_FAILURE=0
MAX_CONCURRENT_REQUESTS=3
SEARCH_MODE=false
SEARCH_PROMPT='（使用搜索工具联网搜索，需要在content中结合搜索内容）'
BLOCKED_MODELS=
MAX_EMPTY_RESPONSES=5
WHITELIST_MODELS=
WHITELIST_USER_AGENT=
PRECISE_CACHE=false

# 🔑 Vertex高级配置
# 是否启用vertex，决定是否使用Vertex AI服务，默认关闭
ENABLE_VERTEX=false 
# 填入完整的Google凭证JSON，用于访问Vertex AI服务的凭证
GOOGLE_CREDENTIALS_JSON=''

同样的，按键盘上的快捷键 Ctrl + O（字母欧），下方出现 File Name to Write 后，按回车保存

再按 Ctrl + X，退出编辑。

输入以下代码检查文件是否已经成功创建完成

cd ~/hajimi && ls -a

应该可以查看到有 docker-compose 和.env 两个文件了。

4. 拉取镜像和启动容器（部署）

输入以下代码

cd ~/hajimi && docker compose up -d

耐心等待启动完成。（大概长这样），主要关注前面全部是 ✅ 就行了，版本不一样这里的代码可能也不一样。

此时，你已经可以通过 [你的 IP]:7860 访问 hajimi 轮询服务了。例如：172.54.56.12:7860（这个是我编的地址，不用访问，用你自己的 IP）

5. 如果在酒馆中使用的话：

调用地址：http://你的服务器 IP:7860/v1 (要加 http 和 /v1，必须是小写 v)

密钥：你写在.env 中 PASSWORD 的值

你可以通过 https://ceshi.laopobao.online 快速测试轮询是否可用。

如果不可用，检查你的 PASSWORD 后面是否有多余的空格或符号。

教程结束。