Initial commit: SMS Forwarder project with Docker support

README.md

@@ -0,0 +1,71 @@
+# SMS Forwarder
+
+一个将 iOS 短信转发到 Android 设备的通知服务器。
+
+## 功能特性
+
+- 接收来自 iPhone 快捷指令的短信内容
+- 支持多种推送方式（Pushbullet、FCM、Gotify、ntfy 等）
+- 基于 FastAPI 的高性能 HTTP 服务器
+- 使用 Apprise 库支持 80+ 种通知服务
+- YAML 配置文件，支持多推送目标
+- API 密钥认证，确保安全性
+- 完整的日志记录和错误处理
+
+## 快速开始
+
+### 1. 环境要求
+
+- Python 3.10+
+- uv 包管理器
+
+### 2. 安装
+
+```bash
+# 克隆项目
+git clone <repository-url>
+cd notification
+
+# 使用 uv 安装依赖
+uv sync
+```
+
+### 3. 配置
+
+复制配置文件模板并编辑：
+
+```bash
+cp config.example.yaml config.yaml
+```
+
+编辑 `config.yaml` 文件，配置你的推送服务。
+
+### 4. 运行
+
+```bash
+# 开发模式
+uv run uvicorn sms_forwarder.main:app --reload --host 0.0.0.0 --port 8000
+
+# 生产模式
+uv run sms-forwarder
+```
+
+## 支持的推送服务
+
+- **Pushbullet** - 推荐，设置简单
+- **FCM (Firebase Cloud Messaging)** - Google 官方推送
+- **Gotify** - 自托管推送服务
+- **ntfy** - 开源推送服务
+- **Discord、Telegram、Slack** 等 80+ 种服务
+
+## iPhone 快捷指令配置
+
+详见 [iPhone 配置指南](docs/iphone-setup.md)
+
+## API 文档
+
+服务器启动后访问 `http://localhost:8000/docs` 查看 API 文档。
+
+## 许可证
+
+MIT License