部署 - 日本語文章解析

你可以把应用部署到 Vercel，也可以用 Docker 运行在自己的服务器上。如果你想让 AI 编程助手代劳，请参阅让 AI Agent 部署。

方式	适合场景
Vercel	没有服务器，想最快上线。
Docker Compose	在 VPS 上长期运行，推荐方式。
docker run	不想使用 Compose 文件。

部署到 Vercel

导入仓库

点击下方按钮，或在 Vercel 中导入 cokice/japanese-analyzer。

Deploy with Vercel

从 GitHub 仓库创建一个新的 Vercel 项目。

配置环境变量

在项目中打开 Settings → Environment Variables，至少添加 DEEPSEEK_API_KEY。需要 Gemini 模型或 Gemini TTS 时，再添加 GEMINI_API_KEY。需要访问密码时，添加 CODE。完整列表见配置。

重新部署

触发一次新部署，然后打开 Vercel 分配的域名。

如果你已经安装并登录了 Vercel CLI，也可以在仓库目录中运行 vercel，用 vercel env add 添加变量，再运行 vercel --prod 发布。

使用 Docker Compose

官方镜像 howenhowen/japanese-analyzer 支持 linux/amd64 和 linux/arm64。容器监听 3002 端口。

准备目录

mkdir -p ~/japanese-analyzer && cd ~/japanese-analyzer
curl -fsSL https://raw.githubusercontent.com/cokice/japanese-analyzer/master/docker-compose.hub.yml -o docker-compose.yml

如果你已经克隆了仓库，可以直接使用其中的 docker-compose.hub.yml。

创建配置文件

创建 .env.production，至少填写一个 Key：

.env.production

DEEPSEEK_API_KEY=your_deepseek_api_key
GEMINI_API_KEY=
CODE=

限制文件权限，避免其他用户读取：

chmod 600 .env.production

启动服务

docker compose up -d

验证

docker compose ps
docker compose logs --tail 50
curl -fsS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3002

容器状态为 running、日志没有报错、curl 返回 200，即部署成功。打开 http://服务器IP:3002 访问应用。

Compose 文件已设置 restart: unless-stopped，服务器重启后容器会自动启动。

docker-compose.hub.yml 内容

services:
  japanese-analyzer:
    image: ${DOCKER_IMAGE:-howenhowen/japanese-analyzer:latest}
    env_file:
      - .env.production
    environment:
      NODE_ENV: production
      PORT: "3002"
      HOSTNAME: 0.0.0.0
    ports:
      - "3002:3002"
    restart: unless-stopped

设置 DOCKER_IMAGE 环境变量可以指定其他镜像标签，例如某个版本标签或 sha-<commit> 标签。可用标签见镜像标签。

修改端口

如果宿主机的 3002 端口已被占用，修改 ports 左侧的宿主机端口，容器内端口保持不变：

ports:
  - "3102:3002"

从源码构建镜像

仓库中的 docker-compose.yml 会从本地 Dockerfile 构建镜像：

git clone https://github.com/cokice/japanese-analyzer.git
cd japanese-analyzer
cp .env.production.example .env.production   # 填入 Key
docker compose up -d --build

使用 docker run

docker run -d \
  --name japanese-analyzer \
  --restart unless-stopped \
  -p 3002:3002 \
  -e DEEPSEEK_API_KEY="your_deepseek_api_key" \
  -e GEMINI_API_KEY="" \
  -e CODE="" \
  howenhowen/japanese-analyzer:latest

需要 Umami 时，再添加：

  -e NEXT_PUBLIC_UMAMI_SRC="https://cloud.umami.is/script.js" \
  -e NEXT_PUBLIC_UMAMI_WEBSITE_ID="your_umami_website_id" \

查看日志：

docker logs -f japanese-analyzer

更新到最新版本

Docker Compose
docker run
Vercel

cd ~/japanese-analyzer
docker compose pull
docker compose up -d

先拉取新镜像，删除旧容器，再用原来的参数重新运行：

docker pull howenhowen/japanese-analyzer:latest
docker rm -f japanese-analyzer
# 再次执行上面的 docker run 命令

docker rm -f 会强制删除容器。执行前确认容器名称，并记下原来的运行参数。

配置域名与 HTTPS

容器正常运行后，你可以为它添加域名和 HTTPS：

解析域名

把域名的 A 记录指向服务器公网 IP。在云厂商安全组和系统防火墙中放行 80 和 443 端口。

检查现有 Web 服务器

command -v nginx caddy

已有 Nginx 或 Caddy 时，直接复用，不要再安装一套。

配置反向代理

your.domain.com {
    reverse_proxy 127.0.0.1:3002
}

server {
    listen 80;
    server_name your.domain.com;

    location / {
        proxy_pass http://127.0.0.1:3002;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
    }
}

Caddy 会自动申请和续期 Let’s Encrypt 证书。使用 Nginx 时，用 certbot 申请证书，并把 HTTP 重定向到 HTTPS。

验证

curl -I https://your.domain.com

返回正常状态码且证书有效，即配置完成。

在 Nginx 中设置 proxy_buffering off，可以避免流式输出被缓冲后一次性返回。

部署自己的修改版

项目采用 AGPL-3.0-only 许可证。如果你修改了代码并通过网络向他人提供服务，需要向用户提供修改版的对应源码，并把界面中的 GitHub 源码链接指向你的实际版本。详见许可证。

开始使用

使用指南

配置与部署

开发

更多

部署

部署到 Vercel

Deploy with Vercel

使用 Docker Compose

修改端口

从源码构建镜像

使用 docker run

更新到最新版本

配置域名与 HTTPS

部署自己的修改版

​部署到 Vercel

Deploy with Vercel

​使用 Docker Compose

​修改端口

​从源码构建镜像

​使用 docker run

​更新到最新版本

​配置域名与 HTTPS

​部署自己的修改版

部署到 Vercel

使用 Docker Compose

修改端口

从源码构建镜像

使用 docker run

更新到最新版本

配置域名与 HTTPS

部署自己的修改版