企业官网建设流程全解析

UniFi Controller SSL证书自动导入：unifi_ssl_import.sh脚本从入门到精通

【免费下载链接】unifi-linux-utilsHelpful Linux / Unix scripts for admins of Ubiquiti (UBNT) UniFi wireless products项目地址: https://gitcode.com/gh_mirrors/un/unifi-linux-utils

UniFi Controller SSL证书自动导入是保障网络安全的重要步骤，而unifi_ssl_import.sh脚本则是实现这一目标的高效工具。本文将详细介绍如何使用该脚本为UniFi Controller自动导入SSL证书，让你的网络管理更加安全可靠。

📋 准备工作：使用unifi_ssl_import.sh前的必备条件

在使用unifi_ssl_import.sh脚本之前，需要确保满足以下要求：

1. 系统已安装并运行UniFi Controller。
2. 拥有有效的2048位私钥、已签名证书和证书颁发机构链文件。注意，UniFi Controller UI不支持4096位证书。

同时，为了确保安全，强烈建议在运行脚本前手动备份keystore文件。keystore的位置根据系统不同而有所区别：

• RedHat系统：$UNIFI_DIR/data/keystore
• Debian/Ubuntu系统：/$UNIFI_DIR/keystore

⚙️ 配置unifi_ssl_import.sh脚本：简单修改即可使用

unifi_ssl_import.sh脚本提供了清晰的配置选项，只需根据你的系统和需求进行简单修改。

基础配置选项

打开脚本文件unifi_ssl_import.sh，找到"CONFIGURATION OPTIONS"部分，主要配置以下内容：

• UNIFI_HOSTNAME：设置UniFi Controller的主机名
• UNIFI_SERVICE：设置UniFi服务名称，默认为"unifi"

系统相关配置

根据你的操作系统，取消相应配置的注释：

Fedora/RedHat/CentOS系统：

UNIFI_DIR=/opt/UniFi JAVA_DIR=${UNIFI_DIR} KEYSTORE=${UNIFI_DIR}/data/keystore

Debian/Ubuntu系统：

UNIFI_DIR=/var/lib/unifi JAVA_DIR=/usr/lib/unifi KEYSTORE=${UNIFI_DIR}/keystore

CloudKey：

UNIFI_DIR=/var/lib/unifi JAVA_DIR=/usr/lib/unifi KEYSTORE=${JAVA_DIR}/data/keystore

Let's Encrypt模式配置

如果使用Let's Encrypt证书，只需将LE_MODE设置为"yes"，并配置LE_LIVE_DIR路径：

LE_MODE=yes LE_LIVE_DIR=/etc/letsencrypt/live

标准模式配置（非Let's Encrypt）

如果不使用Let's Encrypt，需要配置以下证书文件路径：

PRIV_KEY=/etc/ssl/private/hostname.example.com.key SIGNED_CRT=/etc/ssl/certs/hostname.example.com.crt CHAIN_FILE=/etc/ssl/certs/startssl-chain.crt

🚀 运行unifi_ssl_import.sh：轻松完成SSL证书导入

完成配置后，就可以运行脚本导入SSL证书了。在运行脚本之前，请确保你有足够的权限。

运行步骤

1. 打开终端，导航到脚本所在目录
2. 输入以下命令使脚本可执行：chmod +x unifi_ssl_import.sh
3. 运行脚本：sudo ./unifi_ssl_import.sh

脚本执行过程

脚本运行后，会执行以下操作：

1. 检查是否启用Let's Encrypt模式
2. 验证所需文件是否存在
3. 创建临时PKCS12文件
4. 停止UniFi Controller服务
5. 更新证书MD5校验和（仅Let's Encrypt模式）
6. 创建keystore备份
7. 导出SSL证书和密钥数据到临时PKCS12文件
8. 从UniFi keystore中删除之前的证书数据
9. 将SSL证书导入UniFi keystore
10. 清理临时文件
11. 重启UniFi Controller服务

💡 使用unifi_ssl_import.sh的实用技巧

定期自动更新证书

对于Let's Encrypt证书，可以设置cron任务定期运行脚本，实现证书的自动更新。例如，每月运行一次：

0 0 1 * * /path/to/unifi_ssl_import.sh

备份策略

虽然脚本会自动创建keystore备份，但建议定期将备份文件保存到其他安全位置，以防意外发生。

故障排查

如果导入过程中出现问题，可以查看脚本输出的错误信息，或检查以下日志文件：

• UniFi Controller日志：通常位于$UNIFI_DIR/logs/server.log

🛡️ 总结：unifi_ssl_import.sh提升UniFi Controller安全性

unifi_ssl_import.sh脚本为UniFi Controller的SSL证书管理提供了简单而强大的解决方案。无论是使用Let's Encrypt还是其他证书颁发机构，该脚本都能帮助你轻松完成证书导入，提高网络管理的安全性。

通过本文的介绍，你已经掌握了unifi_ssl_import.sh脚本的配置和使用方法。现在，你可以为你的UniFi Controller配置安全的SSL证书，保护网络通信的安全。

记住，定期更新SSL证书是网络安全的重要环节，利用unifi_ssl_import.sh脚本可以让这一过程变得简单而高效。

【免费下载链接】unifi-linux-utilsHelpful Linux / Unix scripts for admins of Ubiquiti (UBNT) UniFi wireless products项目地址: https://gitcode.com/gh_mirrors/un/unifi-linux-utils