# ddns-go-mobile

**Repository Path**: trustbox/ddns-go-mobile

## Basic Information

- **Project Name**: ddns-go-mobile
- **Description**: DDNS-GO Android APK（点开即用 WebView 壳，免 Root）+ Magisk 模块（开机自启）· Run ddns-go on Android: tap-to-use APK & boot-autostart Magisk module (v6.17.6)
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-23
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 介绍
基于https://github.com/SeaSmall/ddns-go-mobile ，增加适配安卓9（32位系统），安卓15，安卓16，增加自动登录功能免账号密码直接进入主界面，默认中文界面，优化安卓竖屏比例显示界面，漂浮保存按钮。

![输入图片说明](release/image.png)


# 🌐 DDNS-GO · Android APK & Magisk 模块

> 在安卓手机上运行 [ddns-go](https://github.com/jeessy2/ddns-go) 动态域名解析（DDNS）服务的两种开箱即用方案：
> 📱 一个「点开即用」的 WebView 封装 APK，🧩 一个「开机自启」的 Magisk 模块。
>
> Two ready-to-use ways to run the [ddns-go](https://github.com/jeessy2/ddns-go) dynamic-DNS (DDNS) service on your Android phone:
> 📱 a tap-to-use WebView wrapper APK, and 🧩 a boot-autostart Magisk module.

![Platform](https://img.shields.io/badge/Platform-Android%208.0%2B-3DDC84?style=flat-square)
![ddns-go](https://img.shields.io/badge/ddns--go-v6.17.6-4FC3F7?style=flat-square)
![WebUI](https://img.shields.io/badge/WebUI-127.0.0.1%3A9876-FF8A65?style=flat-square)
![Root](https://img.shields.io/badge/Root-Not%20Required-81C784?style=flat-square)
![License](https://img.shields.io/badge/License-MIT-FDD835?style=flat-square)

---

## 📖 这是什么 / What is this

**ddns-go** 是一个简单好用的开源 DDNS 工具（Go 编写，MIT 协议）：

- 定时检测公网/内网 IP 变化，自动把域名解析记录同步到 **阿里云、腾讯云、Cloudflare、华为云、Dnspod** 等数十家 DNS 服务商
- 自带 Web 管理界面（默认 `http://127.0.0.1:9876`），改配置、看日志、盯状态都在浏览器里完成
- 无需改路由器、无需公网固定 IP、无需域名服务商的 SDK

**ddns-go** is a simple, open-source (Go, MIT) DDNS tool:

- Periodically detects public/LAN IP changes and auto-syncs DNS records to **Aliyun, Tencent Cloud, Cloudflare, Huawei Cloud, Dnspod** and dozens of providers
- Ships a built-in Web UI (default `http://127.0.0.1:9876`) for configuration, logs and status
- No router config, no static public IP, no vendor SDK required

> 💡 把手机变成一台「永远在线的 DDNS 更新器」，这个仓库给你两种方案。
> 💡 Want to turn your phone into an *always-on DDNS updater*? This repo gives you two options:

| | 📱 **APK（点开即用）** | 🧩 **Magisk 模块（开机自启）** |
|---|---|---|
| **适合场景 / Use case** | 偶尔使用、想随时开关 | 7×24 常驻、开机自动运行 |
| **运行方式 / Runtime** | 打开应用 → 自动启动 ddns-go → 显示 WebUI；退出/划掉 → 自动停止 | 开机自动后台运行，无需操作 |
| **访问界面 / Access** | 应用内 WebView（全屏） | 手机浏览器打开 `http://127.0.0.1:9876` |
| **需要 Root？/ Root?** | 否 | 是（需 Magisk） |
| **配置存放 / Data** | `/data/data/com.ddnsgo.app/files/` | `/data/adb/ddns-go/` |

---

## ✨ 特性 / Features

**📱 APK**
- 打开即运行、关闭即停止（返回键 / 划掉最近任务都会结束 ddns-go 进程）
- 按 Home 回桌面后仍在后台运行，DDNS 持续生效
- 只监听 `127.0.0.1`，不向局域网暴露端口
- 免 Root，Android 8.0+（arm64）

**🧩 Magisk 模块**
- 开机自动后台运行 ddns-go，浏览器直连 `http://127.0.0.1:9876` 管理
- 监听地址 / 数据目录 / 同步频率全部可通过 `ddns-go.conf` 调整（可开放局域网访问）
- 配置与日志持久化在 `/data/adb/ddns-go/`，卸载模块不丢配置
- 与 APK 共存不冲突：模块已占用 9876 时，打开 APK 会自动复用同一实例

---

## 📦 下载与校验 / Download & Checksums

| 文件 / File | 说明 / Description | SHA-256 |
|---|---|---|
| [`release/ddnsgo-6.17.6-r4.apk`](release/ddnsgo-6.17.6-r4.apk) | Android APK（arm64，免 Root） | `8b5ddcfccdc874eb40f780218067cea3815e5ea76121e1eacbab8482c9a5dc12` |
| [`release/ddns-go-magisk-v6.17.6.zip`](release/ddns-go-magisk-v6.17.6.zip) | Magisk 模块（开机自启） | `e9dbef72aab449e680792b117049cfaa0361ef6282c2c00a0b679f7ebe228acc` |

---

## 📱 APK 安装 / APK Installation

1. 把 `ddnsgo-6.17.6-r4.apk` 传到手机（数据线 / 网盘 / 微信均可）
2. 点击安装；自签名应用，系统提示「未知来源」时选择**继续安装**
3. 若之前装过同包名旧版，先卸载再装

**Transfer the APK to your phone, tap to install, and choose "Install anyway" when warned about unknown sources.**

## 🧩 Magisk 模块安装 / Magisk Module Installation

1. 把 `ddns-go-magisk-v6.17.6.zip` 传到手机
2. **Magisk 应用 → 模块 → 从本地安装** → 选择该 zip
3. **重启手机**，开机后 ddns-go 自动运行

**Transfer the zip, then in the Magisk app: Modules → Install from storage → pick the zip → reboot.**

---

## 🚀 使用 / Usage

**APK**：点开图标 → 自动进入 ddns-go WebUI（首次约 1~3 秒）；返回键退出即停止。

**Magisk 模块**：重启后手机浏览器打开 **`http://127.0.0.1:9876`**：

```text
首次打开 → 配置域名与 DNS 服务商（阿里云 / 腾讯云 / Cloudflare / 华为云等）→ 保存
之后每次 IP 变化，ddns-go 自动更新解析记录（默认每 5 分钟检测）
```

**日常管理（Magisk 模块，需 root）/ Daily management (module, root required)：**

```bash
ps -A | grep ddns-go                        # 运行状态 / status
cat /data/adb/ddns-go/ddns-go.log          # 日志 / logs
kill $(cat /data/adb/ddns-go/ddns-go.pid)  # 停止 / stop
sh /data/adb/modules/ddns-go/service.sh    # 手动启动 / manual start
```

---

## ⚙️ 配置 / Configuration

编辑 `/data/adb/modules/ddns-go/ddns-go.conf`（模块内，root 可改）：

```ini
LISTEN_ADDR="127.0.0.1:9876"   # 仅本机访问（默认）；改 0.0.0.0:9876 可开放局域网
DATA_DIR="/data/adb/ddns-go"   # 配置 / 数据库 / 日志目录
SYNC_SEC="300"                 # 同步检测频率（秒）
```

修改后：`kill $(cat /data/adb/ddns-go/ddns-go.pid)` 再 `sh /data/adb/modules/ddns-go/service.sh`，或直接重启手机。

> ⚠️ 开放局域网访问前，请先在 WebUI 里设置登录密码 —— ddns-go 默认无登录认证。

---

## 🔧 从源码构建 / Build from source

```powershell
# 1) 准备工具链（JDK 17 + Android SDK platform-34/build-tools-34，约 500MB）
.\prepare-tools.ps1
# 2) 构建 APK + Magisk 模块 zip（输出到 release\）
.\build.ps1
```

- 无 Gradle / Android Studio 依赖，纯命令行：javac → d8 → aapt2 → zipalign → apksigner
- 换用其它 ddns-go 版本：替换 `app/assets/ddns-go` 与 `magisk/system/bin/ddns-go` 后重新构建
- 两个二进制与 APK 内置二进制均来自 [jeessy2/ddns-go 官方 Release](https://github.com/jeessy2/ddns-go/releases)（android_arm64，v6.17.6）

---

## 🗂 目录结构 / Repository layout

```text
ddns-go-android/
├── README.md                     # 本文件 / this file
├── LICENSE                       # ddns-go (MIT, jeessy2)
├── build.ps1                     # 一键构建 APK + 模块 / build both
├── prepare-tools.ps1             # 下载构建工具链 / fetch toolchain
├── release/                      # 成品 / artifacts
│   ├── ddnsgo-6.17.6-r4.apk
│   └── ddns-go-magisk-v6.17.6.zip
├── app/                          # APK 源码 / APK source
│   ├── AndroidManifest.xml
│   ├── assets/ddns-go            # 内置二进制 / embedded binary
│   ├── res/                      # 图标与资源 / icons & resources
│   └── src/com/ddnsgo/app/       # MainActivity + DdnsService
└── magisk/                       # Magisk 模块源码 / module source
    ├── module.prop               # 模块元数据 / metadata
    ├── service.sh                # 开机自启脚本 / boot autostart
    ├── customize.sh              # 安装钩子 / install hook
    ├── ddns-go.conf              # 可编辑配置 / editable config
    └── system/bin/ddns-go        # 内置二进制 / embedded binary
```

---

## ⚠️ 安全提示 / Security notes

- APK 与模块默认都只监听 `127.0.0.1`；开放局域网访问前**务必先设置 WebUI 登录密码**
- 两个 zip 均自签名（APK 为个人签名，Magisk 模块无签名要求）；请以本页校验和为准
- 配置含 DNS 服务商的 AccessKey / Token，请勿把 `/data/adb/ddns-go/` 或 APK 数据目录分享给他人

---

## 🙏 致谢 / Credits

- [jeessy2/ddns-go](https://github.com/jeessy2/ddns-go) —— 核心 DDNS 引擎（MIT）
- 本项目仅做 Android 封装：官方 android_arm64 二进制 + 轻量壳应用 / Magisk 启动脚本

---

## 📄 许可证 / License

本项目封装代码与 [ddns-go](https://github.com/jeessy2/ddns-go) 本体均遵循 **MIT License**，见 [LICENSE](LICENSE)。