MTranServer 安装与配置指南

MTranServer 安装与配置指南

1. 项目基础介绍

MTranServer 是一个开源的翻译服务器项目，它提供了一个超低资源消耗、超快的离线翻译服务。该项目的目标是实现一个可以私有部署的、类似于 Google 翻译的服务，但具有更低的资源占用和更高的响应速度。主要编程语言为 C++，同时使用了 Python 脚本进行辅助。

2. 项目使用的关键技术和框架

• C++: 项目主要使用 C++ 进行开发，保证了服务器的运行效率和性能。
• TensorFlow: 使用 TensorFlow 深度学习框架训练和部署翻译模型。
• Docker: 使用 Docker 容器技术进行服务的打包和部署，方便了跨平台部署和运维。

3. 项目安装和配置的准备工作

在开始安装前，请确保您的系统满足以下要求：

• 操作系统: Ubuntu 18.04 或更高版本
• Docker: 已安装 Docker 和 Docker Compose
• 网络: 确保您的服务器可以访问互联网以下载 Docker 镜像和模型文件

详细的安装步骤

步骤 1: 克隆项目仓库

首先，您需要从 GitHub 上克隆项目仓库到本地：

git clone https://github.com/xxnuo/MTranServer.git
cd MTranServer

步骤 2: 配置项目

在项目根目录下，创建一个名为 compose.yml 的文件，并填入以下内容：

services:
  mtranserver:
    image: xxnuo/mtranserver:latest
    container_name: mtranserver
    restart: unless-stopped
    ports:
      - "8989:8989"
    volumes:
      - ./models:/app/models
    environment:
      - CORE_API_TOKEN=your_token

请将 your_token 替换为您自己设置的密码，以保护您的服务。

步骤 3: 下载模型

从项目的官方渠道下载您所需的翻译模型，并将其解压到 models 文件夹内。

步骤 4: 启动服务

在项目根目录下，使用以下命令启动服务：

docker compose up

服务启动后，您应该能在控制台看到类似的日志输出，表明服务正在运行。

步骤 5: 使用服务

服务启动后，您可以通过 HTTP API 使用翻译服务。以下是 API 的基本使用方式：

• 普通翻译接口:

  curl -X POST "http://localhost:8989/translate" -H "Content-Type: application/json" -d '{"from": "en", "to": "zh", "text": "Hello, world!"}'
  

• 批量翻译接口:

  curl -X POST "http://localhost:8989/translate/batch" -H "Content-Type: application/json" -d '{"from": "en", "to": "zh", "texts": ["Hello, world!", "How are you?"]}'
  

请根据您的实际需求调整上述命令中的 from 和 to 参数，以及请求的正文内容。

以上步骤即为 MTranServer 的安装和配置指南，祝您使用愉快！