# nascab-releases-gitee

**Repository Path**: nascab/nascab-releases-gitee

## Basic Information

- **Project Name**: nascab-releases-gitee
- **Description**: NasCab官方项目,发布专用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 22
- **Forks**: 9
- **Created**: 2024-11-15
- **Last Updated**: 2025-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[中文文档](README-ZH.md) | [English Documentation](README.md)

#### 此项目为NasCab官方版本发布仓库,git代码方式部署,支持Win,Linux,Mac等多个平台和架构,代码部署方式资源占用少,效率高,支持设备广泛,理论上支持NodeJs的系统都可以部署,推荐低配置系统使用此方式部署
#### NasCab官方网站:https://www.nascab.cn https://www.nascab.online
## 部署方式:
- 1.在您的电脑上安装NodeJs运行环境[版本18或以上] 以及GIT命令行工具[或者其他git客户端]  

- 2.将此项目代码下载到您的电脑上,使用命令行工具进入到您想保存NasCab的目录,运行命令: `git clone https://github.com/nascab/nascab-releases.git`  或者[Gitee] `git clone https://gitee.com/nascab/nascab-releases-gitee`

- 3.进入到项目根目录`cd nascab-releases`,使用npm安装项目依赖, `npm i ` 或者安装yarn(npm i -g yarn)后用 `yarn` 安装依赖


- 4.项目依赖安装成功后,运行项目: `npm run app` 或者 `node ./app/main.js`
- MacOS/Linux平台通过代码部署还需要授予ffmpeg和ffprobe可执行权限,在根目录下输入命令:` chmod -R 777 libs`,不授予可执行权限视频信息将无法读取


- 5.启动大约15秒后,控制台会打印NasCab运行的端口:  
`HTTP 服务正在运行[HTTP server is running] http://192.168.xx.xx:3080 `  
`HTTPS 服务正在运行[HTTPS server is running]  https://192.168.xx.xx:3443 `    

- 6.使用浏览器打开显示的网址即可访问NasCab  

- 7.更新版本:进入到项目根目录,`git pull`  
 
- 8.退出NasCab,在运行NasCab的命令行窗口使用`Ctrl+C`结束进程  

- 9.如果您在Windows平台下使用git代码方式部署,由于ffmpeg.exe超过github的100mb文件体积限制,windows平台所需的ffmpeg.exe文件托管在git lfs上,您还需要安装git lfs,然后在项目根目录执行: `git lfs pull`


# 常见问题:  

- 1.由于中国大陆网络原因,npm安装依赖可能失败,项目已经内置了.npmrc文件配置了中国源,如果您不在中国,可自行删除.npmrc文件   
  
- 2.ffmpeg问题,目前已经内置的ffmpeg可执行文件支持的平台如下:   
Win平台:x64,ia32   
Mac平台:x64,arm64   
Linux平台:x64,arm64    
如果您在其他架构下安装,请自行在libs目录下补充ffmpeg和ffprobe可执行文件   

- 3.NasCab启动后打印的网址无法访问?   
一些情况下,由于用户硬件环境复杂,NasCab打印的ip地址并非实际主机ip,尝试使用您主机网卡的真实局域网ip加NasCab打印的端口进行访问   

- 4.NasCab默认端口   
Linux平台下,NasCab使用3080作为http协议的默认端口,3443作为https协议的默认端口  
其他平台下,NasCab默认使用80和443作为启动端口  

- 5.NasCab默认端口被其他软件占用,我该如何启动?   
默认情况下,如果端口被占用,NasCab会自动将端口顺延,如果因为端口问题无法启动,您可以在项目根目录下创建一个名为httpport.txt的文件,文件内容为临时启动端口,比如:8888,NasCab检测到此文件后会使用文件内容中指定的端口作为启动端口,NasCab成功启动后,您可以进入到配置中心修改http端口为其他端口,然后删除掉httpport.txt文件