A lightweight CDN server with a simple frontend & API.
https://cdn.ziemlich-schnell.de
docker run --name qcdn -p 3000:3000 -e NODE_ENV=production -e SECURITY=enabled -e API_KEYS=none -e PASSWORDS=CHANGEME -v ./data:/usr/src/app/data --restart unless-stopped ghcr.io/arthur2500/qcdn:latest
or
mkdir qCDN &&
cd qCDN &&
wget https://raw.githubusercontent.com/Arthur2500/qCDN/main/docker-compose.yml &&
docker-compose up -d
git clone https://github.com/Arthur2500/qCDN.git &&
docker-compose -f docker-compose.local.yml up -d --build
Requirements:
Node.js >= 16
ffmpeg
Clone Repository
git clone https://github.com/Arthur2500/qCDN.git
Install dependencies
npm install
Run main.js
node main.js
For improved security, set environment variable SECURITY=enabled if exclusively accessed via Cloudflare Tunnel or localhost
SECURITY=enabled node main.js
Frontend authentication key is also passed via environment variable
PASSWORDS=your-passwords-here node main.js
API authentication key is also passed via environment variable
API_KEYS=your-api-key-here node main.js
Header elements which will be placed in the <head> of the page:
HEAD_TAGS='<link rel="stylesheet" href="https://cdn.example.com/styles.css">,<script src="https://cdn.example.com/script.js"></script>'
Links which will be placed in the footer
PRIVACY_LINK=https://example.com/privacy
TERMS_LINK=https://example.com/terms
IMPRINT_LINK=https://example.com/imprint
Or all 3
SECURITY=enabled PASSWORDS=your-passwords-here API_KEYS=your-api-key-here HEAD_TAGS='<link rel="stylesheet" href="https://cdn.example.com/styles.css">,<script src="https://cdn.example.com/script.js"></script>' PRIVACY_LINK=https://example.com/privacy TERMS_LINK=https://example.com/terms IMPRINT_LINK=https://example.com/imprint node main.js
docker-compose.yml Environment Settings:
SECURITY: [enabled/disabled]: Enable/Disable Security features such as Ratelimiting for API and Helmet header protectionPASSWORDS: [$PASSWORDS]: Secure the frontend via these comma separated passwordsAPI_KEY: [none/$CUSTOM_KEYS]: If set to "none," API is disabled. Otherwise, Strings separated by commas are used as access tokens. (see Request Headers)HEAD_TAGS=<link rel="stylesheet" href="https://cdn.example.com/styles.css">,<script src="https://cdn.example.com/script.js"></script>: If set, comma separated HTML tags will be imported into the<head>element of the pagePRIVACY_LINK=https://example.com/privacy: Privacy link which the "Privacy" element in the footer will redirect toTERMS_LINK=https://example.com/terms: TOS link which the "Terms" element in the footer will redirect toIMPRINT_LINK=https://example.com/imprint: Imprint link which the "Imprint" element in the footer will redirect to
Method: POST
Description: Allows authenticated users to upload files via the API and receive a URL for accessing the uploaded file.
x-api-token: API token for authentication.
file: File to upload (multipart/form-data).
- Success: Returns a JSON object containing the uploaded file's URL:
{
"success": true,
"url": "https://example.com/<hash>/<originalName>"
}- Failure: Returns a JSON object with an error message:
{
"success": false,
"message": "Error message"
}curl -X POST http://localhost:3000/api/upload \
-H "x-api-token: YOUR_API_TOKEN" \
-F "file=@/path/to/your/file.txt"import requests
url = "http://localhost:3000/api/upload"
headers = {"x-api-token": "YOUR_API_TOKEN"}
files = {"file": open("/path/to/your/file.txt", "rb")}
response = requests.post(url, headers=headers, files=files)
if response.status_code == 200:
data = response.json()
if data.get("success"):
print("File uploaded successfully:", data["url"])
else:
print("Error:", data)
else:
print("Error:", response.text)Method: DELETE
Description: Allows authenticated users to delete an uploaded file by specifying its hash.
x-api-token: API token for authentication.
- None.
- Success: Returns a JSON object indicating the file was deleted:
{
"success": true
}- Failure: Returns a JSON object with an error message:
{
"success": false,
"message": "Error message"
}curl -X DELETE http://localhost:3000/api/delete/<hash> \
-H "x-api-token: YOUR_API_TOKEN"import requests
url = "http://localhost:3000/api/delete/<hash>"
headers = {"x-api-token": "YOUR_API_TOKEN"}
response = requests.delete(url, headers=headers)
if response.status_code == 200:
data = response.json()
if data.get("success"):
print("File deleted successfully")
else:
print("Error:", data)
else:
print("Error:", response.text)