SkeyeVSS社区版部署说明(github go-vss版本).local

试用安装包下载 | SMS | 试用安装包下载 | 在线演示开源项目地址https://github.com/openskeye/go-vss当前为自构建部署1. 适用范围本文用于本项目的标准化部署覆盖两种方式方式 A单机二进制部署适合本地/现场环境方式 BDocker Compose 部署适合测试/生产环境2. 部署前准备2.1 服务器建议CPU2 核及以上内存4GB 及以上磁盘SSD建议日志与数据分盘网络千兆及以上操作系统Linux 优先Ubuntu/CentOSWindows 可部署2.2 依赖组件MySQL可选若使用 sqlite 可不启Redisetcd媒体服务SkeyesMS必须2.3 开放端口按需11001MySQL11002Redis11003etcd11004Web Proxy11005Media Server HTTP11008VSS SIPTCP/UDP11009Cron11010DB RPC11011Backend API11013VSS HTTP11014VSS SSE11015VSS Cascade SIP11018VSS WebSocketRTP/RTC 端口段按媒体服务配置放行3. 配置准备3.1 环境变量文件在项目根目录准备cp.env.local.default .env.local生产建议使用独立文件如.env.prod或.env.prod.d。3.2 关键参数必须先检查网络SKEYEVSS_INTERNAL_IPSKEYEVSS_EXTERNAL_IP数据库SKEYEVSS_DATABASE_TYPEsqlite/mysqlSKEYEVSS_MYSQL_*mysql 模式下服务发现SKEYEVSS_ETCD_HOSTSKEYEVSS_ETCD_CLIENT_PORT国标 SIPSKEYEVSS_VSS_SIP_IDSKEYEVSS_VSS_SIP_DOMAINSKEYEVSS_VSS_SIP_PASSWORD媒体服务联动SKEYEVSS_MEDIA_SERVER_*SKEYEVSS_MEDIA_SERVER_NOTIFY_*4. 单机二进制部署4.1 启动顺序建议严格按以下顺序启动MySQL / Redis / etcdDB RPCVSSBackend APICronWeb ProxySkeyesMS确保可用并与 VSS 配置一致4.2 启动命令示例go run core/app/sev/db/main.go-env.env.local-fetc/.db-rpc.yaml go run core/app/sev/vss/main.go-env.env.local-fetc/.vss.yaml go run core/app/sev/backend/main.go-env.env.local-fetc/.backend-api.yaml go run core/app/sev/cron/main.go-env.env.local-fetc/.cron.yaml go run core/app/sev/web/main.go-env.env.local-fetc/.web-sev.yaml -web-static-dir前端构建目录媒体服务按其独立参数启动例如SkeyesMS可执行文件-cetc/skeyesms.conf-p110054.3 访问验证平台入口http://IP:11004API经代理http://IP:11004/api-backend默认账号按 envadmin / 1111115. Docker Compose 部署5.1 前置条件已安装 Docker 与 Docker Compose已准备部署目录对应SKEYEVSS_SEV_VOLUMES_DIR已准备 env 文件如.env.prod.d5.2 启动命令在docker-compose.yml所在目录执行docker-compose--profilecore--profileconf up-d如需包含依赖更新或构建流程可按需增加 profileneeded-update、builder等。5.3 查看状态docker-composepsdocker-composelogs-fvssdocker-composelogs-fbackendapi5.4 停止服务docker-composedown6. 健康检查与验收部署完成后建议逐项验收进程/容器都为运行状态DB RPC已注册到 etcdBackend API可正常返回登录接口Web Proxy可访问管理页面GB28181 设备可注册并在线实时播放链路可用VSS - SkeyesMS - 前端日志目录正常写入logs/或挂载目录7. 升级与回滚7.1 升级建议备份MySQL 数据配置文件env etc/*.yaml关键目录日志、证书、静态资源灰度验证先在测试环境验证启动和播放链路正式升级先停业务服务再升级二进制/镜像再按启动顺序恢复7.2 回滚建议保留上一个稳定版本二进制或镜像 tag保留对应 env 与配置快照回滚后优先验证登录设备在线播放录像计划8. 常见问题设备注册失败优先检查 SIP ID/域/密码与防火墙策略。无法播放确认 SkeyesMS 运行正常VSS 通知地址可达。DB RPC 调用超时检查 etcd 注册、Redis/MySQL 连接。页面能开但接口报错检查 Web Proxy 反向代理和 Backend API 监听地址。Docker 启动失败检查 env 文件变量是否完整、宿主机端口是否被占用。