# 离线安装人脸识别服务

本文档介绍如何在没有网络连接的环境下，离线安装基于DLIB的人脸识别服务。
## 1. 准备工作
在开始之前，请确保您已经完成以下准备工作：

- 一台运行Linux操作系统的服务器（推荐使用Ubuntu）
- 已安装Docker和Docker Compose
- 已下载所需的Docker镜像和配置文件（请参考[在线安装](在线人脸识别安装服务docker.md)部分获取下载链接）
- 端口要求：12316（可根据需要修改）
- os已安装curl命令

## 2. 安装步骤

### 2.1 先从云服务器上下载离线安装的镜像包和安装脚本

```
wget https://datacdn.data-it.tech/faceRec/FacRecDocker/facerec.tar

wget https://datacdn.data-it.tech/faceRec/FacRecDocker/install-offline.sh

```

如下所示:

```
facerec.tar  install-offline.sh
```
下载好这两个文件后,将这两个文件拷贝到没有网络的服务器上。

### 2.2 上传或拷贝离线安装包到服务器
将下载好的`facerec.tar`和`install-offline.sh`文件上传或拷贝到目标服务器的某个目录下，例如`/home/user/download`(取决于用户放置目录，不强制要求，用户可放任意目录，要求只有一个，这两个文件在同一个目录)。
```
tst@tst-VMware-Virtual-Platform:~/down$ ls
facerec.tar  install-offline.sh
```
![](https://qncdn.tairongkj.com/docs/images/20250930161123.png)

### 2.3 执行离线安装脚本

```bash
# 先进入放置离线安装包的目录
cd /home/user/download  
# 给安装脚本添加执行权限
sudo chmod +x  install-offline.sh
# 执行安装脚本
sudo ./install-offline.sh
```
命令执行后，系统会自动加载Docker镜像并配置人脸识别服务，整个过程可能需要几分钟时间，请耐心等待。
如下所示:

```
tst@tst-VMware-Virtual-Platform:~/down$ ls
facerec.tar  install-offline.sh
tst@tst-VMware-Virtual-Platform:~/down$ sudo chmod +x ./*.sh
tst@tst-VMware-Virtual-Platform:~/down$ ls
facerec.tar  install-offline.sh
tst@tst-VMware-Virtual-Platform:~/down$ sudo ./install-offline.sh
===============================================
开始离线部署人脸识别服务...
===============================================
[INFO] 2025-09-30 16:19:28 - 检查Docker和Docker Compose是否已安装...
[INFO] 2025-09-30 16:19:28 - Docker和Docker Compose已安装
[INFO] 2025-09-30 16:19:28 - 检查facerec.tar文件...
[INFO] 2025-09-30 16:19:28 - 检测到文件已存在: facerec.tar
[INFO] 2025-09-30 16:19:28 - 正在验证文件完整性...
[INFO] 2025-09-30 16:19:28 - 文件完整性验证通过
[INFO] 2025-09-30 16:19:28 - 导入facerec.tar作为Docker镜像...
[INFO] 2025-09-30 16:22:37 - 成功导入Docker镜像: facerec.tar
[WARNING] 2025-09-30 16:22:37 - 无法直接从docker load输出中提取镜像ID，尝试通过docker images命令获取
[INFO] 2025-09-30 16:22:37 - 成功将镜像 480b2ed60be7 标记为 dt_iot/facerec:latest
[INFO] 2025-09-30 16:22:38 - 创建部署目录: /dt_opt/facerec
[INFO] 2025-09-30 16:22:38 - 复制文件到部署目录...
sending incremental file list
./
install-offline.sh

sent 7,166 bytes  received 38 bytes  14,408.00 bytes/sec
total size is 7,034  speedup is 0.98
[INFO] 2025-09-30 16:22:38 - 创建必要的目录结构...
[INFO] 2025-09-30 16:22:38 - 配置环境变量文件...
[INFO] 2025-09-30 16:22:38 - 创建docker-compose.yml文件...
[INFO] 2025-09-30 16:22:38 - 检查Docker镜像是否已正确导入...
[INFO] 2025-09-30 16:22:38 - 镜像 dt_iot/facerec 已成功导入
[INFO] 2025-09-30 16:22:38 - 加载环境变量...
[INFO] 2025-09-30 16:22:38 - 配置防火墙端口: 12316
防火墙规则已更新
规则已更新(v6)
[INFO] 2025-09-30 16:22:39 - 启动人脸识别服务...
[+] Running 2/2
 ✔ Network dtnet      Created                                                                                                                                               0.5s 
 ✔ Container facerec  Started                                                                                                                                               3.2s 
===============================================
人脸识别服务离线部署完成!
服务地址: http://192.168.10.16:12316
部署目录: /dt_opt/facerec
===============================================
```
![](https://qncdn.tairongkj.com/docs/images/20250930162354.png)

![](https://qncdn.tairongkj.com/docs/images/20250930162541.png)

由上图可见,人脸识别服务，已经成功安装完成。