1.2 部署说明(官网版本).officialSkeyevss 全功能版本部署说明试用安装包下载 | SMS

Skeyevss 全功能版本部署说明

试用安装包下载 | SMS | 试用安装包下载 | 在线演示

项目地址 github.com/openskeye/g…

当前为官网下载的全功能版本

1. 适用范围

方式 A：单机二进制部署（适合本地/现场环境）
方式 B：Docker Compose 部署（适合测试/生产环境）

2. 部署前准备

2.1 服务器建议

CPU：2 核及以上
内存：4GB 及以上
磁盘：SSD，建议日志与数据分盘
网络：千兆及以上
操作系统：Linux 优先（Ubuntu/CentOS），Windows 可部署

2.2 资源准备

二进制选择合适的系统版本下载
- 下载的压缩包包含所有的服务依赖，无需单独安装
- 操作系统 Linux（推荐Ubuntu） / Windows10+
docker 下载

2.3 开放端口（按需）

11001 MySQL
11002 Redis
11003 etcd
11004 Web Proxy
11005 Media Server HTTP
11008 VSS SIP（TCP/UDP）
11009 Cron
11010 DB RPC
11011 Backend API
11013 VSS HTTP
11014 VSS SSE
11015 VSS Cascade SIP
11018 VSS WebSocket
RTP/RTC 端口段（按媒体服务配置放行）

3. 配置准备

3.1 环境变量文件

解压对应的压缩文件后，在文件夹内容：

# 二进制版本 版本
(base) yiyiyi@yiyiyiMac-Studio Skeyevss-linux.amd64.V1.0.6.full % ls -al
total 48
drwx------  6 yiyiyi  staff    192  4 13 15:56 .
drwx--x--x@ 7 yiyiyi  staff    224  4 13 15:56 ..
-rw-r--r--  1 yiyiyi  staff  15036  4 13 15:51 .env.prod
-rwxr-xr-x  1 yiyiyi  staff   2423  4 13 15:53 Skeyevss.sh      # linux
-rwxr-xr-x  1 yiyiyi  staff   2423  4 13 15:53 Skeyevss.bat     # windows
drwx--x--x  9 yiyiyi  staff    288  4 13 15:56 skeyevss-sev
-rwxr-xr-x  1 yiyiyi  staff    108  4 13 15:53 使用说明.txt

```text
# docker 版本
(base) yiyiyi@yiyiyiMac-Studio start % ls -al
total 56
drwxr-xr-x@ 4 yiyiyi  staff    128  4  7 10:18 .
drwxr-xr-x  6 yiyiyi  staff    192  4 13 15:49 ..
-rw-r--r--@ 1 yiyiyi  staff  13061  4  7 10:18 docker-compose.yml
-rw-r--r--@ 1 yiyiyi  staff  12236  4  7 10:18 start.sh

3.2 设置环境变量 .env.prod

必须先检查：

网络：
- SKEYEVSS_INTERNAL_IP
- SKEYEVSS_EXTERNAL_IP
数据库：
- SKEYEVSS_DATABASE_TYPE（sqlite/mysql）
- SKEYEVSS_MYSQL_*（mysql 模式下）
服务发现：
- SKEYEVSS_ETCD_HOST
- SKEYEVSS_ETCD_CLIENT_PORT
国标 SIP：
- SKEYEVSS_VSS_SIP_ID
- SKEYEVSS_VSS_SIP_DOMAIN
- SKEYEVSS_VSS_SIP_PASSWORD
媒体服务联动：
- SKEYEVSS_MEDIA_SERVER_*
- SKEYEVSS_MEDIA_SERVER_NOTIFY_*

4. 启动服务

二进制脚本启动
- windows: 以管理员身份运行 Skeyevss.bat 按照提示输入数字启动
- linux: 以管理员身份运行 sh Skeyevss.sh 按照提示输入数字启动
docker sudo sh start.sh 此命令会自动拉取镜像仓库所依赖的服务
- 详见 docker-compose.yml

================================
          服务管理菜单
================================

1: install      - 安装/启动服务
2: uninstall   - 卸载/停止服务
3: start                - 启动服务
4: stop         - 停止服务
5: restart      - 重启服务

0: exit         - 退出

请输入选项数字:

如果使用nginx代理配置如下:

192.168.50.87 替换为服务器内网ip
showcase.openskeye.cn 替换为你的域名
/etc/nginx/cert/openskeye.cn 证书目录

这些信息你可以根据实际场景配置

upstream ws {
    server 192.168.50.87:11018;
}

upstream ws_stream_play {
    server 192.168.50.87:11005;
}

server {
    listen       443 ssl;
    server_name  showcase.openskeye.cn;

    ssl_certificate         /etc/nginx/cert/openskeye.cn/openskeye.cn.crt;
    ssl_certificate_key     /etc/nginx/cert/openskeye.cn/openskeye.cn.key;
    ssl_session_timeout     10m;
    ssl_session_cache       shared:SSL:10m;

    access_log  /var/log/nginx/showcase.openskeye.cn.access.log;
    error_log  /var/log/nginx/showcase.openskeye.cn.error.log;

    location / {
        proxy_pass http://192.168.50.87:11004/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /sse-event/ {
        proxy_buffering off;
        proxy_cache off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Connection '';
        proxy_read_timeout 24h;
        proxy_send_timeout 24h;
        proxy_pass http://192.168.50.87:11014/;
    }

    # websocket
    location /ws {
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-Ip $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Nginx-Proxy true;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_redirect off;
        client_max_body_size 10m;
        proxy_pass http://ws;
        proxy_connect_timeout 300s;
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }

    # 代理视频播放地址 websocket
    location /sms-play-ws/ {
        proxy_pass http://ws_stream_play/;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_redirect off;
        client_max_body_size 10m;
        proxy_connect_timeout 300s;
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }

    location /sms-play-wss/ {
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-Ip $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Nginx-Proxy true;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_redirect off;
        client_max_body_size 10m;
        proxy_pass http://ws_stream_play/;
        proxy_connect_timeout 300s;
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }

    location /sms-play-http/ {
        proxy_pass http://192.168.50.87:11005/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # 代理视频播放地址 https
    location /sms-play-https/ {
        proxy_pass http://192.168.50.87:11005/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

浏览器中访问:

公网ip:端口: http://192.168.50.87:11004
域名:端口: http(s)://showcase.openskeye.cn
登录用户名默认账号 u:admin p:admin 在第一次访问时需要重新设置密码，当然这些信息也可以在.env.prod中配置

5. 常见问题

设备注册失败：优先检查 SIP ID/域/密码与防火墙策略。
无法播放：确认 SkeyesMS 运行正常，VSS 通知地址可达。
DB RPC 调用超时：检查 etcd 注册、Redis/MySQL 连接。
页面能开但接口报错：检查 Web Proxy 反向代理和 Backend API 监听地址。
Docker 启动失败：检查 env 文件变量是否完整、宿主机端口是否被占用。