🚀 Qlynk Node Master (V09.04.2026 Stable Enterprise Edition) #4
deepdeyiitgn
started this conversation in
Ideas
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
🚀 Qlynk Node Master (V09.04.2026 Enterprise Edition)
Qlynk Node Master is an enterprise-grade, highly secure private cloud storage and streaming datacenter. Engineered to run entirely on Hugging Face Spaces (Free Tier), it acts as a self-sustaining media vault with an integrated Telegram ingestion bot, dynamic anti-hacker defenses, and a cinematic web player.
Built by Deep Dey (12th Grader & JEE Aspirant) 👨💻
📖 The Story & The Architect
🏢 About This Project (The Qlynk Ecosystem)
Qlynk Node Master was born out of a simple engineering challenge: Can we build a limitless, highly secure SaaS ecosystem without paying for traditional cloud storage? Today, it stands as an autonomous datacenter.
👨💻 About Me (The Developer)
I am an aspiring software engineer and full-stack developer based in Tripura, India. I specialize in designing scalable cloud architectures, high-performance web servers, and automated digital infrastructure.
✨ Enterprise Features
asyncio.Lock) to prevent server crashes, automatic MKV to MP4 optimization via FFmpeg, and native thumbnail extraction.200 OKstatus, effectively wasting their time and bandwidth./status) showing core-by-core CPU usage, RAM pool, Network I/O, API latencies, and HF Cloud Quota.🔒 Security & Cryptography (Military-Grade Protections)
This architecture is fortified with advanced cybersecurity protocols designed to defeat scrapers, brute-force bots, and unauthorized access attempts.
404 Not Foundfor invalid links, the server intercepts unauthorized bots and returns a200 OKstatus while feeding them an infinite loop of generated garbage bytes. This actively exhausts the bot's bandwidth and RAM without consuming actual server storage.🛠️ How to Deploy (Build Your Own Enterprise Node)
This architecture is strictly designed to run natively on Hugging Face Spaces (Docker SDK). You do not need an external VPS or paid cloud hosting. Follow these precise steps to deploy your own autonomous media vault:
Step 1: Create the Storage Vault (Database)
The architecture uses Hugging Face Datasets as a limitless, zero-cost private database.
qlynk-storage-vault).history.jsonremain completely secure.your-username/qlynk-storage-vault).Step 2: Create the Main Server (Node)
qlynk-node-master).Step 3: Configure Environment Secrets
Before pushing the code, you must configure the Master Keys. Go to your Space's Settings -> Variables and secrets -> Secrets and add the following mandatory keys:
HF_TOKENWRITEpermissions.DATASET_REPOusername/dataset-name).SPACE_PASSWORD/dashboard).TG_API_IDTG_API_HASHTELEGRAM_BOT_TOKENAUTO_SLUG_ROTATORfalseto disable dynamic URL rotation. Useful if you want to use Qlynk as a permanent CDN for your website's profile pictures or CSS assets. Default istrue.Optional Enterprise Secrets (For Monetization):
CHECKOUT_TOGGLESPACE_PASSWORDto activate the Razorpay SaaS Checkout UI.RAZORPAY_KEY_IDRAZORPAY_KEY_SECRETPROXY_URLStep 4: Clone & Push the Architecture
Open your terminal or command prompt. You will pull the code directly from this GitHub repository and push it to your Hugging Face Space.
Once pushed, Hugging Face will automatically read the Dockerfile, build the secure container, and execute the start.sh bootloader. Within 2-3 minutes, your Enterprise Node will be fully operational. You can then navigate to https://hf.space/.../dashboard to access the Virtual OS.
📂 Project Structure & Main Code
Here is where the core logic lives:
main.py: The heart of the project. Contains the FastAPI server, Media Routing, Token Streaming, Telegram Bot logic, and the Web UI / Dashboard HTML.bot.py: The background organic ping system that prevents the server from sleeping.start.sh: The bootloader script that starts both thebot.pyand theuvicornFastAPI server.history.json: (Generated at runtime) The central database saving all your file metadata securely on Hugging Face Datasets.🛠️ How to Build Your Own Server (Deployment)
You can easily deploy your own private streaming node on Hugging Face Spaces for free!
Step 1: Create a Hugging Face Space
my-private-vault).Step 2: Set up Environment Variables (Secrets)
Go to your Space's Settings -> Variables and secrets -> Secrets and add the following:
HF_TOKENSPACE_PASSWORDTG_API_IDTG_API_HASHTELEGRAM_BOT_TOKENTG_SESSION_STRINGPROXY_URLCHECKOUT_TOGGLERAZORPAY_KEY_IDRAZORPAY_KEY_SECRETYT_COOKIESDOMAIN_1,DOMAIN_2https://mywebsite.com).AUTO_SLUG_ROTATORfalseto disable dynamic URL rotation. Useful if you want to use Qlynk as a permanent CDN for your website's profile pictures or CSS assets. Default istrue.Step 3: Clone and Push the Code
Clone this repository to your local machine and push it to your newly created Hugging Face Space:
git clone [https://github.com/deepdeyiitgn/static-files.git](https://github.com/deepdeyiitgn/static-files.git) cd static-files git remote add hf [https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME](https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME) git push -u hf mainYour server will start building. Once the status says "Running", your private vault is ready!
🆘 Emergency Troubleshooting & Node Diagnostics
Is your datacenter node acting up? Before raising a support ticket, consult this rapid-response diagnostic matrix.
❓ The Omniscient Knowledge Base (50 FAQs)
Click on any question below to reveal the detailed answer.
🏛️ Core Architecture & Hosting
1. What exactly is Qlynk Node Master?
2. Do I need to pay for AWS, GCP, or any VPS hosting?
3. Is my uploaded data public to the world?
4. What programming languages power this engine?
5. Can I use a Custom Domain (like mywebsite.com)?
6. What happens if the Hugging Face Space goes to sleep?
7. Why is there a Dual-License on this repository?
8. What does "System Hiatus" mean?
9. How is the database managed without SQL?
10. Can I deploy this on Render or Heroku instead?
🛡️ Military-Grade Security
11. What is the Honeypot (Tarpit) mechanism?
12. Why do my file URLs change automatically?
13. Can I turn off the dynamic URL rotation?
14. How does the IP Banning (Fail2Ban) work?
15. What if a legitimate user makes a typo and gets banned?
16. How is the Master Dashboard secured?
17. Can someone bypass the payment gateway to get tokens?
18. Are my Telegram messages end-to-end encrypted?
19. Why does the API return JSON by default?
20. What prevents DDOS attacks on the API?
📤 Data Ingestion & Storage
21. What is the maximum file size I can upload?
22. What happens if I upload multiple files at once?
23. What is the
/batchcommand?24. How do I upload files via YouTube or Instagram links?
25. What is the
/indexdeep-scan bypass?26. Can I upload non-media files like ZIPs or PDFs?
27. What happens if my
history.jsonis accidentally deleted?28. How are thumbnails generated?
29. Where do the files actually live?
30. Is there a storage limit on Hugging Face Datasets?
🎬 Cinematic Streaming & Media
31. What makes the Web Player "Cinematic"?
32. Why do MKV/AVI files take longer to process?
33. How does Tokenized Streaming work?
34. Can Internet Download Manager (IDM) steal the videos?
35. Does the video stop buffering if I pause for 4 hours?
36. How do I add Subtitles to a video?
37. Does the player support SRT subtitles?
38. Can I adjust the subtitle size?
39. Does the player have Picture-in-Picture (PiP)?
40. How does the spacebar fast-forward work?
💼 SaaS Checkout & Administration
41. How do I enable the Razorpay Checkout?
42. What do users receive after a successful payment?
43. Can users log in to multiple devices with one token?
44. How does the AI Helpdesk (
/support) work?45. How do I reply to support tickets?
46. What is the Virtual Master OS?
47. What does "Clear Active Sessions" do in the dashboard?
48. What is the Universal Preview Engine?
49. Can I bulk delete files?
50. How accurate is the "Server Health" tab?
⚖️ Legal Disclaimers & Fair Use Warnings
yt-dlpand Media Extraction:This project utilizes the
yt-dlplibrary solely as a technical demonstration of media routing and extraction architectures.This repository operates under a Strict Attribution & Non-Commercial Custom License.
🌟 Final Note from the Developer
Building Qlynk Node Master and taking it to an Enterprise SaaS level has been an incredible engineering journey. If you found this architecture helpful or learned something new about API security, rate-limiting, and Python web servers, please give this repository a ⭐ Star!
Signing off for now. Dreaming of IIT Kharagpur CSE. Keep coding, keep building! 🚀📚
📅 Last System Update (Hiatus Locked): Friday, 10 April 2026 | 01:24 PM IST (GMT+05:30)
🔒 Architecture completely locked and deployed.
This discussion was created from the release 🚀 Qlynk Node Master (V09.04.2026 Stable Enterprise Edition).
All reactions