Apinest

开源 API 管理 / 接口文档协作平台 Open-source API management & documentation collaboration platform

中文 | English

Apinest（ApiNest）是一套可自托管的 API 协作管理平台，用于集中管理接口文档、环境变量与团队权限。适合作为 Postman / Apifox 等工具的轻量自托管替代方案。

仓库一览

仓库	说明
nest-api	后端服务（Go）
nest-web	Web 前端（Vue 3）
nest-desktop	桌面客户端（Tauri 2）

它是做什么的

把团队放进同一个工作空间，按项目、文件夹组织接口，配置多套环境与变量，邀请成员共同编辑，再通过分享链接把指定接口开放给无需登录的访问者。

适合替代零散的文档表格或私有接口清单，让接口定义、环境切换与协作权限落在同一处。

在线演示

• 地址：https://nest.lengyuye.top/login
• 账号：admin
• 密码：123123

快速开始

镜像地址：Docker Hub · zerunx/nest

docker pull zerunx/nest:latest

部署前提

• 需自行准备可访问的 PostgreSQL（建议 14+）
• 当前不支持内置数据库，连接信息在首次安装向导中填写，无需配置容器环境变量
• 镜像已包含前端与后端，默认监听 3000
• 请挂载 runtime 目录到宿主机，用于持久化安装配置

Docker Compose

services:
  nest:
    image: zerunx/nest:latest
    ports:
      - "3000:3000"
    volumes:
      - ./runtime:/app/runtime
    restart: unless-stopped

docker compose up -d

Docker Run

docker run -d --name nest \
  -p 3000:3000 \
  -v ./runtime:/app/runtime \
  zerunx/nest:latest

反向代理

Nginx、Caddy 等只需把流量反代到 Apinest 服务（默认 http://127.0.0.1:3000 或容器网络中的 nest:3000），前后端同源，无需单独部署静态站点。

your.domain.com {
    reverse_proxy nest:3000
}

完成安装

浏览器访问站点后按安装向导填写 PostgreSQL 连接信息与管理员账号，完成后即可登录使用。

技术栈

层级	技术
后端	Go · Gin · Ent · JWT · Zap · WebSocket
前端	Vue 3 · TypeScript · Vite · Element Plus · Vue Router · Axios
桌面端	Tauri 2 · Rust · Vue 3 · SQLite
基础设施	Docker · PostgreSQL · Valkey · Caddy

特性

• 工作空间与项目：创建、重命名、删除；按项目归档接口资产
• 接口文档：文件夹分层、接口 CRUD、请求/响应相关字段管理
• 环境与变量：多环境配置，便于本地 / 测试 / 生产切换
• 成员协作：邀请加入工作空间，按角色控制编辑权限
• 项目分享：生成分享记录，访客无需登录即可查看勾选接口
• 桌面客户端：本地同步与发请求，支持环境变量替换与请求历史
• 系统能力：安装向导、用户鉴权、管理后台、中英双语

License

ApiNest is licensed under the Apache License 2.0