# sms

**Repository Path**: diypb/sms

## Basic Information

- **Project Name**: sms
- **Description**: DbusSmsForward
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-25
- **Last Updated**: 2026-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# sms

#### 介绍
DbusSmsForward 是一款基于 DBus 的 4G 短信自动转发工具，可将设备收到的短信实时转发到钉钉等通知渠道，适合无人值守的 4G 网关/路由设备使用。

#### 软件架构
- 主程序：`DbusSmsForward`（Go 语言编译的可执行文件）
- 配置文件：`appsettings.json`（用户本地配置，包含渠道密钥等敏感信息，不上传仓库）
- 服务托管：通过 `systemd` 实现后台守护、开机自启与异常自动重启
- 定时任务：通过 `cron` 实现每日自动清理旧短信，避免存储空间占满
- 运维工具：`sms_menu.sh` 一键菜单脚本，简化服务管理与日志查看

#### 安装教程
1.  以 **root 权限**登录目标设备，执行一键部署命令：
    ```bash
    wget -qO- https://gitee.com/diypb/sms/raw/master/deploy.sh | bash
    ```
2.  脚本自动下载主程序后，会引导你手动配置转发渠道（如选择钉钉并输入机器人密钥），完成后按 `Ctrl+C` 停止程序。
3.  脚本自动配置后台服务、开机自启与每日清理任务，部署完成后输入 `menu` 即可打开运维菜单。

#### 使用说明
1.  日常管理：输入 `menu` 打开一键运维菜单，可查看服务状态、重启服务、实时查看日志、手动清理短信等。
2.  修改配置：编辑 `/root/appsettings.json` 文件，修改后执行 `menu` → 选择 `4` 重启服务生效。
3.  查看日志：执行 `menu` → 选择 `5` 可实时查看短信转发日志，排查问题。
4.  定时清理：默认每日凌晨 2 点自动清理旧短信，可通过 `crontab -e` 修改执行时间。

#### 参与贡献
1.  Fork 本仓库
2.  新建功能分支 (`git checkout -b feature/xxx`)
3.  提交代码 (`git commit -am 'Add some feature'`)
4.  推送至分支 (`git push origin feature/xxx`)
5.  新建 Pull Request