快速开始

本章节将引导您完成 comp-hub 的安装和启动，整个过程不超过 5 分钟。

环境要求

• Node.js >= 16.0.0
• npm >= 8.0.0

支持框架

框架	版本	状态
Vue	2.x	✅ 支持
Vue	3.x	✅ 支持
React	-	⏳ 规划中

安装

方式一：全局安装（推荐）

全局安装 comp-hub CLI，安装后可直接使用 comphub 命令：

npm install comp-hub@latest -g

方式二：本地开发依赖安装

仅在当前项目中安装，适合团队协作场景：

npm install comp-hub@latest -D

启动服务

全局安装后启动

在项目目录下执行：

comphub

本地安装后启动

如果使用的是 -D 本地安装，需要通过 npx 执行：

npx comphub

启动成功后，终端会显示类似以下输出：

✅ comp-hub v0.24.11
2026-04-17 20:38:56.589 INFO 25672 cwd: /path/to/your/project
2026-04-17 20:38:56.589 INFO 25672 env: prod
2026-04-17 20:38:56.602 INFO 25672 [midway:socketio] Socket.io server start success and attach to web server
2026-04-17 20:38:56.611 INFO 25672 Local Address: http://localhost:5000
2026-04-17 20:38:56.611 INFO 25672 Network Address: http://192.168.x.x:5000
2026-04-17 20:38:56.611 INFO 25672 [midway:bootstrap] current app started

使用浏览器访问显示的地址（默认为 http://localhost:5000），即可进入 comp-hub 平台。

CLI 命令行参数

您也可以通过命令行参数来配置启动选项：

comphub [options]

参数说明：

参数	简写	类型	默认值	说明
--port	-p	number	5000	启动端口
--dir	-d	path	"./"	资源目录相对路径
--log	-l	level	"info"	日志等级
--version	-v	-	-	显示版本号
--help	-h	-	-	显示帮助信息

使用示例：

# 指定端口启动
comphub -p 8080

# 指定资源目录和日志等级
comphub -d ./src -l debug

# 查看版本号
comphub -v

# 查看帮助信息
comphub -h

配置说明

如需自定义端口或指定组件目录，可在项目根目录创建 .comphub.json 或 .comphub.js 文件：

配置文件格式

JSON 格式（.comphub.json）：

{
  "port": 5000,
  "dir": "./src",
  "log": "info",
  "allowDebug": false
}

JS 格式（.comphub.js）：

module.exports = {
  port: 5000,
  dir: './src',
  log: 'info',
  allowDebug: false
}

配置项说明

配置项	类型	默认值	说明
port	number	5000	服务启动端口
dir	string	"./"	组件代码根目录的相对路径，上传/下载时只能操作该目录及其子目录
log	string	"info"	日志等级，可选值："debug", "info", "warn", "error"
allowDebug	boolean	false	是否允许调试模式

配置文件加载优先级

1. 优先尝试加载 .comphub.json
2. 如果 JSON 文件不存在，尝试加载 .comphub.js
3. 如果都不存在，使用默认配置

配置优先级

配置值的优先级从高到低：

1. 命令行参数（如 -p 8080）
2. 配置文件（.comphub.json 或 .comphub.js）
3. 默认配置

下一步

服务启动后，您可以：

• 上传组件 — 将您的组件发布到平台
• 预览下载 — 查看和使用其他组件