Skip to main content

Happy Server 私有部署

· 2 min read

本文整理自 Happy 官方文档,介绍如何在自己的基础设施上部署 Happy 中继服务器,从而完全掌控 Claude Code 的移动端接入。

服务器端部署​

Docker私有部署​

  1. 在当前目录创建子目录 docker_volumes_data 和 docker-compose.yml 文件
  2. 执行 sudo docker compose up -d --force-recreate happy-server
docker-compose.yml
services:
  happy-server:
    image: alanway/happy-server:20260725-v2
    command: ["sh", "-c", "pnpm --filter happy-server-self-host exec prisma migrate deploy && pnpm --filter happy-server-self-host start"]
    ports:
      - "3500:3005"
    restart: unless-stopped
    environment:
      - NODE_ENV=production
      - DATABASE_URL=postgresql://postgres:postgres@postgres:5432/happy-server
      - REDIS_URL=redis://redis:6379
      - HANDY_MASTER_SECRET=7AlTRroCX9Xx
      - DB_PROVIDER=postgres
      - PORT=3005
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:15
    environment:
      - POSTGRES_DB=happy-server
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    volumes:
      - ./docker_volumes_data/postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    volumes:
      - ./docker_volumes_data/redis_data:/data

volumes:
  postgres_data:
  redis_data:
注意

HANDY_MASTER_SECRET 是服务器的访问密钥,部署时请将其替换成自己生成的随机字符串,切勿直接使用示例值。

命令行私有部署​

# 安装依赖
npm install -g happy-server-self-host --registry=https://registry.npmmirror.com

# 然后查看命令行最新帮助文档进行部署，该部署方式需要自己创建 Redis 和 Post 服务
happy-server-self-host --help

客户端连接​

在个人电脑上执行以下步骤:

  1. 执行命令 npm install -g happy --registry=https://registry.npmmirror.com 安装 happy-cli
  2. 创建文件 ~/.happy/settings.json, 内容见文章底部
  3. 执行命令 happy login --force, 选择 Mobile App 方式认证
  4. 手机下载 Happy 客户端扫码
~/.happy/settings.json
{
  "serverUrl": "https://your_self_host_domain"
}