File size: 2,277 Bytes
42a7d7b
 
 
 
96b5930
42a7d7b
 
 
 
 
96b5930
 
b47e0f4
 
 
96b5930
 
 
 
 
 
42a7d7b
 
 
96b5930
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# Changelog

All notable changes to this project will be documented in this file.

## [1.0.0] - 2026-04-24

### πŸŽ‰ Initial Release

#### Features

- **Self-hosted n8n** β€” Runs the latest n8n on HuggingFace Spaces Docker using SQLite (no external DB required).
- **Persistent Backup** β€” Automatically syncs the entire n8n workspace (workflows, credentials, database) to a private HF Dataset.
- **Cloudflare Transparent Proxy** β€” Built-in fix to bypass platform network blocks for Telegram, WhatsApp-related APIs, Google integrations, Discord, and other outbound services.
- **Automatic Cloudflare Worker provisioning** β€” Hugging8n can now create or update its outbound proxy automatically from `CLOUDFLARE_WORKERS_TOKEN`, matching HuggingClaw's auto-setup flow.
- **Google node coverage widened** β€” Worker defaults now cover Google API families more broadly so Sheets, Drive, Gmail, OAuth, and related nodes work without manual domain tuning.
- **Premium Dashboard** β€” Beautiful web interface at `/` for real-time uptime monitoring and sync health tracking.
- **Built-in Keep-Alive** β€” Integrated UptimeRobot setup tool directly from the dashboard to prevent free HF Spaces from sleeping.
- **Native Security** β€” Optimized for n8n v2 native user management with hardened file permissions (`umask 0077`).
- **Safe Persistence** β€” Uses atomic SQLite backups to ensure data integrity during periodic syncs.
- **Auto-Restore** β€” Seamlessly pulls the latest state from your HF Dataset on every startup.
- **Graceful Shutdown** β€” Ensures a final backup pass is completed on `SIGTERM` / `SIGINT` before the container exits.

#### Architecture

- `Dockerfile` β€” Optimized build on `node:22-slim` including all n8n and sync dependencies.
- `start.sh` β€” Orchestrates startup, validates environment, and manages service lifecycle.
- `health-server.js` β€” High-performance namespace proxy and dashboard server.
- `cloudflare-proxy.js` β€” Transparently intercepts and routes blocked traffic via Cloudflare Workers.
- `n8n-sync.py` β€” Robust background sync engine using the `huggingface_hub` API.
- `start.sh` β€” Configures environment, restores backup, and launches background sync loop.

---
*Made with ❀️ by [@somratpro](https://github.com/somratpro)*