eworkerinc/language-services

E-Worker语言服务（.NET 10）

Language Services允许E-Worker使用LanguageTool本地运行拼写和语法检查，无需将LanguageTool直接暴露给浏览器。

• E-Worker与Language Services通信（而非直接与LanguageTool通信）
• 默认情况下，LanguageTool嵌入在同一容器中运行
• 所有非公开路由均需身份验证
• 支持HTTPS（当E-Worker通过HTTPS运行时推荐使用）
• Java和fastText通过apt安装；LanguageTool服务器文件来自官方LanguageTool归档

Docker镜像

• Language Services（.NET + 嵌入式LanguageTool）：eworkerinc/language-services:0.7.2

重写版本的版本策略：

• 保持相同的镜像仓库（eworkerinc/language-services）
• 为.NET运行时版本更新标签（推荐下一个主要/次要标签：0.7.2）
• 从当前稳定标签继续发布latest

快速启动（Docker Compose）

默认的Compose片段仅在127.0.0.1上发布Language Services。当运行E-Worker的浏览器与Docker在同一机器时使用此配置。

yaml
services:
  language-services:
    image: docker.xuanyuan.run/eworkerinc/language-services:0.7.2
    restart: unless-stopped
    environment:
      HTTP_HOST: 0.0.0.0
      HTTP_PORT: "8687"
      HTTPS_HOST: 0.0.0.0
      HTTPS_PORT: "8688"
      TLS_CERT_PATH: /certs/service.crt
      TLS_KEY_PATH: /certs/service.key
      LANGUAGE_SERVICE_TOKEN: change-me
      LANGUAGETOOL_URL: http://127.0.0.1:8010
      LANGUAGETOOL_TIMEOUT_MS: "15000"
      LANGUAGETOOL_JAVA_XMS: "1g"
      LANGUAGETOOL_JAVA_XMX: "8g"
      LANGUAGETOOL_MAX_CHECK_THREADS: "12"
      LANGUAGETOOL_MAX_WORK_QUEUE_SIZE: "256"
      LANGUAGETOOL_MAX_CHECK_TIME_MILLIS: "25000"
      LANGUAGETOOL_CACHE_SIZE: "20000"
      LANGUAGETOOL_CACHE_TTL_SECONDS: "600"
      LANGUAGETOOL_PIPELINE_CACHING: "true"
      LANGUAGETOOL_MAX_PIPELINE_POOL_SIZE: "128"
      LANGUAGETOOL_PIPELINE_EXPIRE_SECONDS: "600"
    ports:
      # 仅本地：当浏览器在同一机器运行时使用
      - "127.0.0.1:8687:8687"
      - "127.0.0.1:8688:8688"
      # LAN访问：当浏览器从其他机器调用https://<host-or-ip>:8688时，替换上面两行
      # - "0.0.0.0:8687:8687"
      # - "0.0.0.0:8688:8688"
    volumes:
      - ./certs:/certs:ro

对于机器IP/LAN访问，Docker必须在主机接口上发布端口。如果Docker仍绑定到127.0.0.1，仅防火墙规则无法使https://<host-or-ip>:8688可达。

使用嵌入式LanguageTool服务器时，保持LANGUAGETOOL_URL=http://127.0.0.1:8010。该URL是容器内部的；浏览器应通过端口8688调用Language Services，而非通过端口8010调用LanguageTool。

对于LAN HTTPS，生成或安装包含用户将在E-Worker中输入的准确主机名或IP地址（例如language-service.local、workstation.lan或192.168.0.10）的SAN证书。

如果想使用外部LanguageTool而非嵌入式LT：

• 设置LANGUAGETOOL_EMBEDDED_ENABLED=false
• 设置LANGUAGETOOL_URL=http://<external-host>:8010

验证

bash
docker ps --format "table {{.Names}}\t{{.Ports}}"

# 仅本地发布：
# 127.0.0.1:8688->8688/tcp

# LAN发布：
# 0.0.0.0:8688->8688/tcp

curl -k https://127.0.0.1:8688/healthz -H "Authorization: Bearer change-me"
curl -k https://127.0.0.1:8688/v2/languages -H "x-api-key: change-me"
curl -k https://127.0.0.1:8688/v2/check -H "Authorization: Bearer change-me" -H "Content-Type: application/json" --data '{"text":"Ths is tesst","language":"en-US"}'

对于LAN安装，还需从其他机器验证：

bash
curl -k https://<host-or-ip>:8688/healthz -H "Authorization: Bearer change-me"

如果主机响应ping但端口8688超时，说明Docker仍绑定到127.0.0.1，或主机防火墙/网络配置仍阻止入站TCP 8688。