luci-app-aliddns 项目使用教程
项目介绍
luci-app-aliddns 是一个为 AliDDNS 提供 LuCI 控制界面的 OpenWrt/LEDE 软件包。该项目允许用户通过 Web 界面轻松配置和管理阿里云动态域名解析服务,实现动态 IP 地址到固定域名的自动映射。
目录结构说明
项目采用标准的 OpenWrt 软件包结构:
luci-app-aliddns/
├── etc/
│ ├── config/
│ │ └── aliddns // UCI 配置文件
│ ├── init.d/
│ │ └── aliddns // init 脚本
│ └── uci-defaults/
│ └── luci-aliddns // uci-defaults 脚本
└── usr/
├── sbin/
│ └── aliddns // 主程序
└── lib/
└── lua/
└── luci/ // LuCI 部分
├── controller/
│ └── aliddns.lua // LuCI 菜单配置
├── i18n/ // LuCI 语言文件目录
│ └── aliddns.zh-cn.lmo
└── model/
└── cbi/
└── aliddns.lua // LuCI 基本设置
配置文件详解
UCI 配置文件
配置文件路径:/etc/config/aliddns
config base 'base'
option enable '0'
option time '10'
配置说明:
enable: 是否启用 AliDDNS 服务(0=禁用,1=启用)time: 检查时间间隔(分钟)
启动脚本
启动脚本路径:/etc/init.d/aliddns
该脚本提供完整的服务管理功能:
# 启动服务
/etc/init.d/aliddns start
# 停止服务
/etc/init.d/aliddns stop
# 重启服务
/etc/init.d/aliddns restart
# 查看状态
/etc/init.d/aliddns status
LuCI 界面配置
LuCI 界面提供了直观的配置选项:
- 启用开关: 控制整个服务的启用状态
- 清理更新: 更新前是否清理记录
- IPv4/IPv6 支持: 分别启用 IPv4 和 IPv6 支持
- Access Key: 阿里云 Access Key ID 和 Secret
- WAN IP 源: 选择 WAN 接口作为 IP 地址来源
- 域名配置: 主域名和子域名设置
- 检查时间: 动态 IP 检查间隔(1-59分钟)
- 更新日志: 实时显示服务运行日志
依赖要求
软件包正常运行需要以下依赖:
openssl-util: OpenSSL 工具集curl: 网络传输工具
编译安装
从 LEDE SDK 编译:
# 解压 SDK
tar axvf lede-sdk-17.01.*-ar71xx-generic_gcc-5.4.0_musl-1.1.16.Linux-x86_64.tar.xz
cd lede-sdk-17.01.*-ar71xx-*
# Clone 项目
mkdir -p package/feeds
git clone https://gitcode.com/gh_mirrors/lu/luci-app-aliddns.git package/feeds/luci-app-aliddns
# 编译 po2lmo(如需要)
pushd package/feeds/luci-app-aliddns/tools/po2lmo
make && sudo make install
popd
# 选择编译包
make menuconfig
# 开始编译
make package/feeds/luci-app-aliddns/compile V=s
使用说明
- 在 LuCI 界面中进入"服务" -> "AliDDNS"
- 启用服务并配置阿里云 Access Key
- 设置域名信息(主域名和子域名)
- 选择 WAN 接口作为 IP 地址来源
- 设置合适的检查时间间隔
- 保存并应用配置
服务启动后会自动在后台运行,定期检查 WAN IP 变化并更新阿里云 DNS 记录。所有操作日志可以在 LuCI 界面的"更新日志"标签页中查看。
注意事项
- 确保路由器能够正常访问互联网
- 阿里云 Access Key 需要具有 DNS 修改权限
- 建议设置合理的检查时间间隔,避免过于频繁的请求
- 服务状态可以通过系统日志或 LuCI 界面查看
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



