企业官网建设流程全解析

简介：EasyDSS-windows-2.2.7-1912281435.zip 面向需要在 Windows 环境部署流媒体服务的开发者、运维人员及教学使用者，围绕视频上传、转码、直播、回放、分享和多屏播放等常见需求，提供一站式本地化视频管理方案，也可用于企业内训、在线教育、会议直播等场景的功能验证。压缩包共 207 个文件、约 55.93MB，内含 exe、dll、so 等可执行程序与动态库，承担服务启动、编解码和运行支撑；前端资源以 js、css、html 为主，另配 lua 脚本、字体图标以及 conf、pem、json 等配置与证书文件，目录按模块组织，方便检索和二次集成。目前已有 708 人学习或下载。读者可在 Windows 上完成安装并跑通直播推流、视频转码、回放与网页嵌入流程，还能参考配置文件、接口示例和脚本组织方式，对接自有业务系统或开展二次开发，适合作为流媒体功能验证、项目预研及教学演示的素材。

1. 装 EasyDSS 2.2.7：一个黑窗口闪退，能让人熬到凌晨两点

现场部署最怕的不是不会装，而是“以为装完了”。把 EasyDSS-windows-2.2.7-1912281435.zip 拷到服务器 D 盘，双击里面那个 exe，黑色命令行窗口闪一下就没了，桌面干干净净，服务列表里也查不到任何东西——这是我在视频管理类项目里见得最多的一种翻车。这套包本身不复杂，一个流媒体服务端加一套 Web 控制台，管 RTSP/RTMP 推流、HLS 与 HTTP-FLV 播放、录像回看和转推，几十路摄像头的小项目一台 Windows 机器就扛得住。但它的启动顺序卡得很死：路径带中文、端口被占、服务注册方式选错，任意一条不对，日志里就一行看不懂的报错，然后你再点十次也是一样的结果。这一篇按我自己的落地顺序记录：先量环境，再跑控制台，再注册服务，最后用三条链路验证。适合第一次把这套安装包放到 Windows 上的人，也适合装过但没装明白的人。

2. 装前把环境列清：2.2.7 这个包吃什么样的 Windows

安装包里没有安装向导，解压即用，所以“环境检查”这一步没有人替你拦，全部得自己过一遍。我在现场通常先花十分钟做三件事：确认系统位数和补丁、把要用的端口全部扫一遍、把落盘路径定下来。这三件事做完，后面 90% 的启动失败都能提前掐掉。反过来，跳过这十分钟直接解压启动，最常见的结局是控制台窗口一闪而过，你连报错都来不及截屏。

2.1 系统版本与运行库：x64、VC++ 运行库和别省的补丁

2019 年底构建的这版 Windows 包是 64 位的，32 位系统不用试。服务端本体是原生编译的程序，不依赖完整的 .NET 框架，但依赖 VC++ 运行库，缺了它的典型症状是双击之后立刻退出，事件查看器里能看到“应用程序错误 0xc000007b”这类模块加载失败。另外这台机器如果是 Server 2012 R2，务必把系统补丁打到一个比较新的水平，老补丁集下 TCP 连接数和高并发下的句柄回收都有坑，表现出来就是几十路流同时拉的时候偶发断流，非常玄学。

我一般按下面这张表逐项对，缺哪项补哪项，别凭感觉：

时间同步这一条很多人不在意，但流媒体服务对时间戳极其敏感。服务器时间和推流端差出几分钟，HLS 的 m3u8 里切片序列就会乱，播放器能拉到列表但一直转圈。装之前先把w32tm校准，比事后查半天强。

:: 查看当前时间源与偏差，偏超过 5 秒就先校准再往下走 w32tm /query /status w32tm /resync /force

/query /status关注的是“源”和“上次成功同步时间”两行，源为空说明这台机器根本没配时间源，得先w32tm /config /manualpeerlist:... /update指过去。/resync /force是强制立即同步一次，执行完再查一遍确认偏差归零。这一步不影响安装，但影响你后面验证录像时长准不准。

2.2 端口与磁盘：解压前先跑三条检查

端口冲突是这套包上线阶段最高频的故障，因为它的默认端口很“大众”：Web 控制台常见是 10080，RTMP 推流常见是 1935（个别小版本会改成 10035，解压后在配置里确认一下），RTSP 是 554。10080 容易被同机的其它 Web 服务占，1935 容易被已经装过的其它流媒体软件占，554 更麻烦——Windows 上有些组件会监听低位端口。

磁盘这块要按“路数 × 码率 × 时长 × 保留天数”估。一路 2 Mbps 的流，一天约 21 GB，10 路存 15 天就是 3 TB 出头。录像目录千万别和系统盘放一起，写满 C 盘之后 Windows 本身就开始各种异常，服务假死只是其中最轻的一种。

:: 一条命令看三个关键端口有没有被占，最后一列是占用进程 PID netstat -ano | findstr ":10080 :1935 :554"

输出里如果出现LISTENING，记下最后一列的 PID，再用tasklist /FI "PID eq 1234"查是哪个程序。查出来是系统进程就换端口，是遗留的旧服务就停掉再删。空结果才是干净可用的状态。顺手把磁盘也看一眼：

:: 看各盘剩余空间，录像盘至少留出 30% 余量 wmic logicaldisk get caption,freespace,size

freespace单位是字节，除以 1024 三次就是 GB。我给自己的规矩是录像盘剩余低于 20% 就触发清理，不等到写满。

2.3 解压路径与目录结构：为什么不能放 Program Files 和中文目录

路径问题听起来像玄学，但在这类原生编译的服务端上是实打实的。C:\Program Files\下面有 UAC 和虚拟化重定向，服务以 SYSTEM 身份跑的时候写日志、写切片文件可能被重定向到VirtualStore，表现就是“控制台能跑，注册成服务后录像目录空的”。中文路径则是另一回事，部分模块在拼 URL 和文件路径时没有做编码处理，日志里会出现一堆问号，然后切片写不出来。

我固定用D:\EasyDSS\这种纯英文、无空格、层级浅的路径。解压后典型结构是这样（不同小版本文件名会有出入，以包里实际为准）：

D:\EasyDSS\ ├─ EasyDSS.exe 主程序 ├─ *.ini / *.conf 配置文件，改前先备份 ├─ www\ Web 控制台静态资源 ├─ logs\ 运行日志 ├─ data\ 数据库与索引 └─ record\ 默认录像目录（建议改到独立盘）

www目录丢了会表现为网页打开空白，data目录权限不对会表现为登录后一直转圈。解压工具也有讲究：用系统自带解压或者 7-Zip，别用某些会把中文文件名转码的国产压缩软件，解出来的目录名可能是乱码，程序按固定名字找文件就找不到了。解压完先dir看一眼文件名是否正常，这一步花十秒，能省掉半小时的排查。

注意：原始 zip 包留一份在别的地方别动，后面改配置改崩了，最省事的后悔药就是重新解压覆盖。

3. 第一次启动：先控制台跑通，再注册成服务

很多人跳过控制台直接注册服务，出问题之后既看不到输出又找不到日志，等于把自己关进了黑匣子。我的顺序永远是：控制台能稳定跑十分钟 → 再注册服务 → 再验证服务模式下的行为。控制台模式下所有输出直接打在屏幕上，出错的第一现场全在那儿。

3.1 解压、改名、留一份原始包

解压目标定为D:\EasyDSS\，然后立刻做两件事：备份配置文件、确认 exe 的位数和依赖。备份这一步别省，配置文件是这套系统里唯一“改错了就启动不了”的东西，而它往往没有图形化界面可以回滚。

:: 进目录，备份配置，顺便确认主程序是 64 位 cd /d D:\EasyDSS for %f in (*.ini *.conf) do copy "%f" "%f.bak_20191228" dumpbin /headers EasyDSS.exe | findstr "machine"

第一行切盘符加目录，/d是允许跨盘切换。第二行把所有 ini/conf 复制一份带日期后缀的备份，改坏了直接改回来。第三行需要 VS 命令行环境，没有就跳过，用任务管理器看进程有没有*32标记也能判断。备份文件名带上构建日期20191228，是因为这套包的版本号后面那串1912281435就是构建时间戳，写进文件名以后好对账。

3.2 控制台首启：看到这几行才算真的起来了

控制台启动有两种方式：直接双击 exe，或者在 cmd 里带配置参数启动。我推荐后者，因为窗口不会一闪而过，报错留在屏幕上。启动后正常情况下会依次看到端口监听、数据库加载、Web 服务就绪这几类输出。

:: 前台启动，指定配置文件，输出同时留一份到 logs\console.log cd /d D:\EasyDSS EasyDSS.exe -c .\easydss.ini 2>&1 | more

-c指定配置文件路径，不同版本可能是-config或直接读同目录固定名字的文件，以包内说明为准，先用默认不带参数启动一次确认它能自己找到配置。2>&1把标准错误合并到标准输出，否则很多初始化失败的信息根本不会显示。管道接more是为了让输出分屏停住，方便你逐行看，不想分屏就去掉。

判断“起来了”的标准不是窗口没关，而是下面三件事同时成立：

1. 输出里出现监听10080（或你改过的端口）的成功提示；
2. 浏览器访问http://127.0.0.1:10080/能出登录页；
3. logs\目录下有当天的日志文件，且内容是正常初始化流程，不是反复重启的循环。

三条里有任何一条不成立，就不要往下走了。这时候最快的定位手段是回到 cmd 窗口往上翻，找第一条 Error。找不到就去logs\里搜error和failed，日志里的第一条错误一定是根因，后面的都是连锁反应。

提示：控制台窗口不要用“关闭按钮”关，用 Ctrl+C 让它自己退出。直接关窗可能留下没释放的端口和半截写入的切片文件，下次启动会报端口占用。

3.3 注册 Windows 服务：三种方式的取舍

控制台跑通之后才谈注册服务，因为服务的运行身份、工作目录、环境变量都和控制台不一样，这是第二类高频故障的来源。包里通常会带一个注册服务的小工具或者 bat 脚本（不同小版本名字会变，比如install.bat、service.exe之类），也可以自己用系统命令注册。三种方式我按推荐度排：

第一种，用包里自带的注册脚本。最省事，工作目录和参数都配好了，缺点是有些版本会把服务名写死，一个机器上装两个实例就冲突。

第二种，用sc create手动注册。可控性最好，能自己指定工作目录和服务名。

:: 手动注册服务：binPath 里必须带配置文件的绝对路径，start= auto 表示开机自启 sc create EasyDSS binPath= "D:\EasyDSS\EasyDSS.exe -c D:\EasyDSS\easydss.ini" start= auto DisplayName= "EasyDSS Media Server" sc description EasyDSS "video management service, port 10080" sc start EasyDSS

注意binPath=、start=后面那个空格是必须的，sc的语法就这脾气，少一个空格会报“参数无效”。binPath里要给绝对路径，因为服务的默认工作目录是C:\Windows\System32，用相对路径它会去系统目录找配置文件，然后启动失败。sc start之后立刻sc query EasyDSS看状态，RUNNING才是成功，START_PENDING卡住基本就是启动过程中崩了。

第三种，用 nssm 之类的第三方包装器。好处是能自动拉起、能重定向日志，坏处是多一层依赖，出问题时排查链路变长。我一般只在需要“崩了自动重启”的场景下才上。

三种方式共同的坑是运行身份。服务默认以 LocalSystem 跑，它对D:\EasyDSS\一般有权限，但如果录像目录放在网络共享或者别的用户的目录下，就会出现在控制台模式下能录、服务模式下录不了的情况。这种时候要么改目录权限，要么在服务属性里把登录身份改成有权限的账号。

# 给服务账号授权录像目录，避免"控制台能录、服务不能录" icacls "D:\EasyDSSData\record" /grant "NT AUTHORITY\SYSTEM:(OI)(CI)M" /T

(OI)(CI)表示对象继承和容器继承，M是修改权限，/T递归应用到子目录。这条命令执行完不用重启也能生效，但已经在写文件的句柄要等服务重启后才用新权限。

4. 配置项逐个改：端口、录像盘、日志和鉴权

配置是这套系统里唯一需要“读一遍再动手”的部分。我的做法是先只改必须改的，把服务跑起来，再按需动其它项。一次改十个参数然后起不来，你根本不知道是哪个参数的问题。

4.1 配置文件里我每次必动的几个键

配置文件是 ini 风格，字段名不同小版本会差一两个字，下面这几组是我每次必动的，键名以你解压出来的那份为准，值按这个思路填：

; 改前已备份为 easydss.ini.bak_20191228 [http] port = 10080 ; Web 控制台与 HTTP-FLV 共用，被占就换 10081 ssl_port = 10443 ; 不上 HTTPS 可以留空或注释掉 [rtmp] port = 1935 ; 推流口，包内默认可能是 10035，以实际为准 [record] root = D:\EasyDSSData\record ; 挪到独立数据盘，别留 C 盘 keep_days = 15 ; 按容量算，2Mbps × 10 路 ≈ 21GB/天/路 [log] level = info ; 排障期用 info，稳定后可以降到 warn max_size_mb = 100 ; 单文件上限，配合轮转防止日志撑爆磁盘

[http] port是最常改的一个，因为 10080 太容易撞。改完之后控制台地址、拉流地址、前端调用的 API 地址全部跟着变，所以改之前先想清楚有没有外部系统写死了这个端口。ssl_port不用 HTTPS 就直接注释掉，留着一个没证书的端口监听反而会拖慢启动。

[rtmp] port这个字段值得单独说一句：这套包的默认推流端口在不同小版本之间变过，1935 和 10035 都见过。别照着网上抄，解压后打开配置文件看一眼实际值，后面拼推流地址的时候要用。这个值改了，所有推流端配置都要跟着改，属于“改一次疼一次”的项。

[record] root是我最看重的一项。默认录像目录一般就在安装目录下，直接把 C 盘暴露给录像写入。挪到独立数据盘之后，还要注意路径里别带中文和空格，原因和第 2 章说的一样。keep_days要和磁盘容量对上，配大了就是定时炸弹。

[log] level在排障期必须是info，稳定运行一两周后再降到warn，否则日志增长很快，max_size_mb配得再小也架不住高频写。

4.2 防火墙与端口放行：别等客户打电话才想起来

Windows 防火墙默认拦入站，本机访问一切正常，局域网访问全挂——这是我在现场接到最多的一通电话。端口放行要在装完当天就做掉，不要等联调。

# 放行 Web 控制台、RTMP 推流、RTSP 三类入站，只对需要的端口开，别整体关防火墙 New-NetFirewallRule -DisplayName "EasyDSS-HTTP" -Direction Inbound -Protocol TCP -LocalPort 10080 -Action Allow -Profile Domain,Private New-NetFirewallRule -DisplayName "EasyDSS-RTMP" -Direction Inbound -Protocol TCP -LocalPort 1935 -Action Allow -Profile Domain,Private New-NetFirewallRule -DisplayName "EasyDSS-RTSP" -Direction Inbound -Protocol TCP -LocalPort 554 -Action Allow -Profile Domain,Private

-Profile Domain,Private是关键，只对域和专用网络生效，公共网络配置文件下不开，避免机器接到外网时把这几个口暴露出去。端口号要和你配置文件里实际改过的值一致，改过端口还用默认值放行等于没放。

放行之后不要在本机用127.0.0.1测，本机回环不走防火墙，测不出问题。用同网段的另一台机器访问http://<服务器IP>:10080/，能出登录页才算通。连不上就先ping确认通，再telnet 服务器IP 10080确认端口，两步都通还是打不开，那就是服务没监听在 0.0.0.0 上，回配置文件看有没有绑定到 127.0.0.1。

提示：改完防火墙规则先用Get-NetFirewallRule -DisplayName "EasyDSS-*"确认规则存在且 Enabled 是 True，再去找别的原因，别在规则没生效的情况下瞎猜。

4.3 录像盘与日志轮转：把 C 盘摘出去

录像和日志这两个东西的共同点是“默默增长，直到把盘写满”，而盘写满之后这套服务的表现不是干脆报错，而是各种奇怪的假死：Web 页面打得开但登录不了，推流能推但切片不生成。所以它们必须在装完的当天就落到正确的盘上。

录像目录改完配置后要手动创建并确认权限，别指望程序自己建：

# 建录像根目录并给 SYSTEM 完全控制，程序以服务身份跑时必须这一步 New-Item -ItemType Directory -Force -Path "D:\EasyDSSData\record" icacls "D:\EasyDSSData\record" /grant "NT AUTHORITY\SYSTEM:(OI)(CI)F"

日志轮转除了配置里的max_size_mb，我还会加一个系统层的兜底：用计划任务每天凌晨清理超过 30 天的日志文件。这类小脚本看着土，但它救过我两次现场。

# 每天凌晨三点清理 30 天前的日志，注册成计划任务长期跑 $cut = (Get-Date).AddDays(-30) Get-ChildItem "D:\EasyDSS\logs\*.log" -Recurse | Where-Object { $_.LastWriteTime -lt $cut } | Remove-Item -Force -ErrorAction SilentlyContinue

AddDays(-30)是保留窗口，按你的排障需求调，一般 30 天够用了。-ErrorAction SilentlyContinue是为了避开正在被占用的文件，不加的话脚本会因为一个文件报错中断，后面的都不执行。

5. 避坑与排查：上线前最容易翻车的五件事

下面这五条是我在现场真实遇到过的，每一条都能独立让服务起不来，而且现象都很像，所以按“现象 → 原因 → 解决”记下来，下次看到同样的症状能直接对号。

5.1 双击 exe 后黑窗口闪一下就没了

现象：控制台窗口出现不到一秒就消失，没有任何报错可见，任务管理器里也没有残留进程。

原因：三种可能。一是缺 VC++ 运行库，程序加载阶段就失败；二是解压路径带中文或空格，读取配置时异常退出；三是配置文件本身有语法错误，解析失败直接退出。

解决：先在 cmd 里手动执行而不是双击，让输出留在屏幕上。闪退发生在加载阶段且没有任何业务日志，基本就是运行库问题，装一遍 2015-2019 x64 运行库再试。有输出但停在读配置那一行，就把配置文件恢复成.bak备份再启动，能起来说明是改坏了。路径问题最好判断，换个D:\EasyDSS\重解压一次对比就知道。

5.2 服务注册成功，但启动立刻停止，报错 1067

现象：sc start EasyDSS返回失败，sc query看到状态在STOPPED，事件查看器里是“进程意外终止，错误代码 1067”。

原因：服务的工作目录是C:\Windows\System32，binPath里用了相对路径，程序找不到配置文件。或者配置文件里的某些路径写的是相对路径，控制台模式下当前目录对，服务模式下就错了。

解决：把binPath里的配置路径改成绝对路径，配置文件中所有涉及目录的项（录像、日志、数据）也全部改成绝对路径。改完先sc delete EasyDSS再重新sc create，不要用sc config硬改，容易残留旧参数。

5.3 Web 页面能打开，登录后一直转圈

现象：登录页出得来，输账号密码点登录，转圈几十秒后超时或者直接空白。

原因：多半是data\目录权限不对或者数据库文件损坏。服务模式下以 SYSTEM 跑，如果data\是从别的机器拷贝过来的、带着原来的 ACL，SYSTEM 可能没有写权限，读得到写不了，登录会话就建立不起来。另一个可能是控制台静态资源www\版本和 exe 不匹配，比如你只覆盖了 exe 没覆盖 www。

解决：先看当天日志有没有数据库相关报错，有就先停服务把data\整个备份出来再重建。权限问题用icacls给 SYSTEM 授全权。版本不匹配的情况更常见于“从别的现场拷了个 exe 过来”，这种时候老老实实整包重新解压覆盖，别只换单个文件。

5.4 推流显示成功，但拉流地址 404

现象：推流端 ffmpeg 没报错，控制台里也能看到这条流，但播放器打开拉流地址返回 404 或者一直缓冲。

原因：一是拉流地址的路径规则拼错了，直播流和录像回看的路径前缀不一样，很多人拿网上抄的地址直接套；二是 HLS 切片目录没有写权限，m3u8 生成不出来，看着像 404；三是防火墙只放行了推流端口，没放 Web 端口，播放器走的是 HTTP。

解决：从控制台里复制它给出的那条拉流地址，不要自己拼。切片目录权限按 4.3 的做法授一遍。防火墙确认 10080 对客户端网段是通的，用同网段机器curl -I试一下 m3u8 地址，看返回码是 404 还是超时，这两个结果指向完全不同的方向。

5.5 跑了两三天，服务开始假死

现象：前两天一切正常，第三天开始 Web 打开慢、推流断断续续，重启服务就恢复，过两天又犯。

原因：按概率排，第一是磁盘写满，录像盘或者日志盘满了之后写操作阻塞；第二是句柄泄漏，长时间运行后连接数逼近上限；第三是服务器时间漂移导致切片时间戳错乱，客户端反复重连把连接数打满。

解决：先看盘，wmic logicaldisk get caption,freespace一眼就能排除。盘没满就查时间同步，w32tm /query /status看偏差。两个都正常再怀疑句柄，任务管理器里看句柄数和线程数的增长趋势，重启后记一个基线，跑一天再对比，涨得离谱就是泄漏，这种只能升级版本或者控制并发路数，重启不是解决办法。

6. 装完怎么验证跑通：三条链路加一个半小时观察法

装完不等于跑通。我判断这套环境是否合格的唯一标准是三条链路全通：控制台链路、推拉流链路、录像链路。三条都过，才敢跟人说“装好了”。

第一条，控制台链路。用同网段的另一台机器（不是本机回环）访问，登录后能正常加载设备列表和流列表。

# 从客户端机器验证 Web 端口，200 才算通；超时就是防火墙或监听地址问题 curl -I -m 5 http://192.168.1.20:10080/

-I只取响应头，-m 5是五秒超时，避免卡在那儿等。返回200或302都算通，302是跳登录页，正常。

第二条，推拉流链路。用 ffmpeg 循环推一个本地文件，模拟长时间推流，然后分别验证 RTMP 和 HLS 两种拉流方式。

# 循环推流 30 分钟，-re 按真实帧率发，别用 -stream_loop -1 加不加 -re，会把服务打满 ffmpeg -re -stream_loop -1 -i demo.mp4 -c copy -f flv rtmp://192.168.1.20:1935/live/test # 另开一个窗口，拉 m3u8，路径从控制台里抄，别自己猜 curl -I -m 5 http://192.168.1.20:10080/live/test.m3u8

-re让 ffmpeg 按原始帧率发送，不加的话会全速灌进去，几十秒推完 30 分钟的内容，测不出稳定性问题。-c copy不转码，省 CPU 也更接近真实摄像头的码流。m3u8 返回200且有内容长度，说明切片在正常生成。

第三条，录像链路。推流跑够两分钟以上，去录像目录看有没有按时间命名的文件，再用 ffprobe 验一下时长对不对。

# 看录像文件时长，和实际推流时长对不上就是切片或时间戳有问题 ffprobe -v error -show_entries format=duration -of default=nw=1:nk=1 record_20200101_120000.mp4

返回的秒数应该和推流时长基本一致，差出十几秒通常是关键帧间隔太大或者时间戳没对齐，这种情况回配置里把切片时长调小一点。

三条都过了，我还会加一个半小时观察法：让循环推流继续跑着，每五分钟采一次样，看三样东西。

半小时是经验值，太短看不出泄漏，太长现场等不起。有一次我图省事跳过了这半小时，第二天早上客户打电话说系统卡死，远程一看是日志把 C 盘写满了，那一刻的心情现在还记得。从那以后我每次装这类包，都强制走一遍这三条链路加半小时观察，哪怕只是改了一个端口号。希望帮到你。

本文还有配套的精品资源，点击获取