¶简介

简单来说，一言指的就是一句话，可以是动漫中的台词，也可以是网络上的各种小段子。或是感动，或是开心，有或是单纯的回忆。来到这里，留下你所喜欢的那一句句话，与大家分享，这就是一言存在的目的。

¶1.部署

一言官方提供了各种部署方式，自己选一个，这里使用 Docker 部署

cd ~
#创建hitokoto目录
mkdir -p hitokoto

#进入hitokoto目录
cd hitokoto

创建一言配置文件

vim config.yml

**填写配置信息 **

下面自己本次配置信息

name: 'hitokoto' # 服务名称，例如：hitokoto
url: 'https://v1.hitokoto.cn' # 服务地址，例如：https://v1.hitokoto.cn
api_name: 'demo_api_name' # 服务标识，取个好区分的标识吧，例如：cd-01-demo
server: # 配置 HTTP 服务的信息
  host: hitokoto_api # 监听的地址
  port: 8080 # 监听的端口
  compress_body: true # 是否使用 GZIP 压缩
redis: # 配置 Redis
  host: hitokoto_db # Redis 主机名
  port: 6379 # Redis 端口
  password: '' # Redis 密码
  database: 0 # Redis 数据库
sentences_ab_switcher: # 本节是服务 AB 异步更新的配置，如果您不知道这个是什么意思，请保持默认
  a: 1 # a 状态对应的 redis 数据库
  b: 2 # b 状态对应的 redis 数据库
remote_sentences_url: https://cdn.jsdelivr.net/gh/hitokoto-osc/sentences-bundle@latest/ # 语句库地址，通常默认即可。如果您想使用您自己打包部署的语句库，您可以修改此项
workers: 0 # 启动 Worker 数目。0 表示启动和 CPU 核心数相同数量的 Worker
extensions: # 控制扩展
  netease: true # 网易云音乐接口
requests:
  enabled: true # 是否启用请求数目统计
  hosts: # 需要单独统计的主机名
    - v1.hitokoto.cn
    - international.v1.hitokoto.cn
    - api.a632079.me
    - api.hitokoto.cn
    - sslapi.hitokoto.cn
telemetry: # 遥测服务
  performance: true # 性能监控
  error: true # 错误报告
  usage: true # 使用报告
  debug: false # 是否启用调试模式（该模式会让遥测服务打印调试信息）

创建docker-compose.yml 文件

vim docker-compose.yml

配置docker-compose.yml文件

version: "3.8"  # Docker Compose 文件的版本

services:
  # Redis 服务
  hitokoto_db:
    image: redis:6.0.8  # 使用 Redis 6.0.8 镜像
    # 可以添加更多 Redis 配置项，例如环境变量、持久化等
    restart: always

  # Hitokoto API 服务
  hitokoto_api:
    image: hitokoto/api  # 使用 Hitokoto API 镜像
    restart: always
    ports:
      - 8080:8080  # 将容器的 8080 端口映射到主机的 8080 端口
    depends_on:
      - hitokoto_db  # 确保 hitokoto_api 在 hitokoto_db 启动后启动
    volumes:
      - ./config.yml:/usr/src/app/data/config.yml:ro  # 将主机的 config.yml 文件挂载到容器中的指定路径，并以只读模式挂载
    # 可以添加更多配置项，例如环境变量、启动命令等

运行一言容器

docker-compose up -d

运行一言容器

¶2.测试

浏览器输入ip+8080端口是否成功返回

测试结果

¶参考

[^1]: 部署实例 | 一言开发者中心 (hitokoto.cn)