imoog
A simple to use database-based deployable CDN node for hobbyist developers who wish to have their own CDN!
Setup
- Clone this repo via this command:
git clone https://github.com/justanotherbyte/imoog - Go into the
imoog/settings.pyfile and adjust your settings. Examples for both database drivers have been provided in the file. - Install a production asgi server of your choice. The 2 I recommend are
hypercornanduvicorn. Installing their base packages will suffice. - To automatically install the respective dependencies, please run
pip install -r requirements.txtin the directory where you wish to store your node. - It is recommended to house the
imoogfolder within another folder, as there are other files that come with this repo, that are not housed within theimoogfolder.
Settings
- imoog offers granular control over many key aspects of the node. Most of these can be extremely overwhelming. Go ahead and hop into the
imoog/settings.pyfile, where you'll find detailed explanations of each and every setting. - Another thing that can be overwhelming are the 2 database drivers. How do you configure them? What are their optimal settings. Again, everything is explained inside the
imoog/settings.pyfile.
Proxy
- In order to use this node cleanly, I recommend placing yourself behind a proxy server. One of the most popular choices is
NGINX.
Caching + Cloudflare
- The Imoog Node handles a lot of the caching for you, however, a good next step would be to place your CDN on cloudflare.
- Cloudflare has some awesome caching solutions. Also, overall, they make it easy to expose your CDN to the open-web.
Uploading Files
This Node receives files via multipart/form-data. So it's best if you were to adapt your upload system to this. The field name the node expects is just file, so please upload it with this name. Please remember to register the Authorization header. This key can be set in the imoog/settings.py file.
Upload example (aiohttp)
import aiohttp
import asyncio
async def main():
session = aiohttp.ClientSession()
form = aiohttp.FormData()
form.add_field("file", b'imagebyteshere', content_type="bytes")
resp = await session.post("http://localhost:8000/upload", data=form, headers={"Authorization": "myawesomesecretkey"})
returned_data = await resp.json()
print(returned_data)
await session.close()
asyncio.get_event_loop().run_until_complete(main())
>>> {'status': 200, 'file_id': 'FSTSH2RPI'}
Driver and dependency information
Internally, imoog uses 2 different libraries for the 2 different supported database drivers.
Both of these libraries are currently the best in their field for asynchronous client side connections to their respective databases.
9 Dec 13, 2022
1 Oct 23, 2021
0 Jan 23, 2022
2 Dec 15, 2021
0 Jan 2, 2022
4 Oct 15, 2022
5 Oct 31, 2022
1 Dec 30, 2021
2 Jan 6, 2022
4 May 23, 2022
3 Jan 12, 2022
216 Dec 30, 2022
6 May 10, 2022
52 Jan 06, 2023
1 Jan 03, 2022
3 Feb 08, 2022
1 Dec 17, 2021
12k Jan 02, 2023
4 Sep 30, 2022
0 Oct 31, 2021
92 Jan 25, 2022
329 Dec 31, 2022
4 Dec 12, 2022
108 Dec 29, 2022
2 Dec 10, 2022
394 Dec 17, 2022
151 Dec 26, 2022
7.3k Jan 03, 2023
4 Dec 28, 2021