hoya0803/charging-logger

🔋 旅途充电记录系统

开车出门，一键记录每次充电的位置、费用和评价。 手机浏览器打开就能用，数据永久保存在自家 NAS 上。

---

功能一览

---

快速部署

方式一：Docker Run（最快）

bash
docker run -d \
  --name charging-logger \
  -p 5000:5000 \
  -v /path/to/data:/data \
  --restart unless-stopped \
  hoya0803/charging-logger:latest

方式二：Docker Compose（推荐）

yaml
services:
  charging-logger:
    image: hoya0803/charging-logger:latest
    container_name: charging-logger
    restart: unless-stopped
    ports:
      - "5000:5000"
    volumes:
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai

关键：-v /path/to/data:/data 挂载数据库目录，容器删除数据不丢。

---

⚠️ HTTPS 是 GPS 定位的前提

浏览器从 2016 年起规定：只有 HTTPS 页面才能调用 GPS 定位。HTTP 下会直接静默拒绝。

解决方案：用反向代理（Nginx/Lucky/Cloudflare）套一层 HTTPS。

推荐域名配置：

• 内网访问：http://NAS_IP:5000（无 GPS，需手动输坐标）
• 外网访问：https://你的域名（GPS 正常，手机 4G 可用）

---

环境变量

---

使用流程

刷新页面续传：充电过程中如果误关/刷新页面，重新打开会自动恢复计时状态。

---

数据说明

• 数据库：SQLite，单文件 /data/charging.db
• 备份：直接复制 data/charging.db 即可
• 迁移：把 data/ 目录拷贝到新机器，启动容器数据自动恢复

---

技术栈

• 后端：Python 3.11 + Flask + Gunicorn + SQLite
• 前端：原生 HTML/JS + Tailwind CSS + Leaflet 地图
• 容器：Docker（python:3.11-slim）
• 自动构建：GitHub Actions → Docker Hub

---

镜像信息