openilink-hub

环境要求

• Linux / macOS 系统（使用一键安装脚本时）
• Docker 环境（选择 Docker 方式部署时）
• PostgreSQL 17（生产环境 Docker Compose 方案使用 postgres:17-alpine）
• 本地 Go 环境（仅运行 App Mock Server 调试时需要）
• 一个可用的域名并可配置 Nginx / Caddy 做 HTTPS 反代

安装与启动步骤

1. 1一键安装

   在 Linux / macOS 终端执行脚本下载并安装 openilink-hub 命令行工具，安装完成后可用 oih 命令。

   curl -fsSL https://raw.githubusercontent.com/openilink/openilink-hub/main/install.sh | sh

   复制

2. 2启动服务

   直接用安装好的 oih 命令启动平台，这是脚本安装方式的默认启动入口。

   oih

   复制

3. 3Docker 单容器启动

   不想用脚本就选 Docker 方式（二选一），把容器 9800 端口映射到宿主机 9800。

   docker run -d -p 9800:9800 openilink/openilink-hub:latest

   复制

4. 4生产环境编排

   需要 PostgreSQL 的场景用 Docker Compose，把下面的 yaml 保存为 docker-compose.yml 后再启动。

   docker compose up -d

   复制

5. 5启动 Mock Server

   本地开发调试用，把事件通过 Webhook 投递到你自己的 App 回调地址。

   go run ./cmd/appmock --webhook-url http://localhost:8080/webhook

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:9800 能看到控制台即部署成功；Docker 方式可用 docker ps 确认容器在运行。

常见问题

注意事项

• 本项目基于公开的 iLink 协议独立开发，仅供学习交流与技术研究，与 iLink 官方团队无关联或授权关系。
• Compose 示例中的数据库密码和 SECRET 均为占位值，上线前务必替换为强密码和随机字符串。
• Docker 命令中的 9800:9800 为示例端口映射，如需改端口可调整宿主机一侧的映射。
• README 中一键安装脚本仅标注支持 Linux / macOS。