NotAShelf/go-cdn
1
0
Fork 0
mirror of https://github.com/NotAShelf/go-cdn.git synced 2024-11-22 07:50:42 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
An experimental CDN project in Go.
11 commits 2 branches 0 tags 68 KiB
Go 100%
Find a file
NotAShelf 9a5d191c46
try to get path relative to main executable
2023-06-03 21:14:43 +03:00
.github/workflows sample Go workflow 2023-06-03 19:56:31 +03:00
.gitignore separate config and example config 2023-06-03 19:57:58 +03:00
example_config.json separate config and example config 2023-06-03 19:57:58 +03:00
go.mod improve logging and error handling 2023-06-03 20:14:42 +03:00
go.sum improve logging and error handling 2023-06-03 20:14:42 +03:00
LICENSE Initial commit 2023-06-03 18:19:23 +03:00
main.go try to get path relative to main executable 2023-06-03 21:14:43 +03:00
README.md add usage instructions 2023-06-03 19:20:30 +03:00

README.md

go-cdn

An experimental CDN project in Go.

Features

  • Serve static files securely over HTTP
  • Basic authentication support
  • File upload functionality

Possible use cases

The CDN can be used in various scenarios, such as:

  • Hosting static assets (i.e images or Javascript files) for web applications
  • Distributing files securely to authorized users
  • Building a personal or small-scale CDN for content delivery

Usage

Starting the CDN

  1. Build the program
go build
  1. Run the built binary

Using the CDN

To request a file from the CDN, use the following URL format:

http://your-cdn-server:port/file-path

Replace your-cdn-server with the hostname or IP address of your CDN server and port with the port number on which the server is running. Append the desired file path after the hostname and port.

Example:

  • http://localhost:8080/images/file_you_have_uploaded.png

    • If the file exists and the request is authorized, the file will be served by the CDN.
    • If the file doesn't exist, a 404 Not Found response will be returned.

Uploading Files to the CDN

Send a POST request to the /upload endpoint of the CDN server.

Example using cURL:

curl -X POST -u username:password -F "file=@/path/to/file" http://your-cdn-server:port/upload

Replace username and password with the authentication credentials you have set in the main.go file. Replace your-cdn-server with the hostname or IP address of your CDN server and port with the port number on which the server is running. Provide the file path after the @ symbol in the -F parameter.

Example:

curl -X POST -u admin:password -F "file=@/absolute/path/to/image.jpg" http://localhost:8080/upload

- The uploaded file will be saved in the specified uploadPath directory.

Note: The server responds with a success message if the file upload is successful.

Security Considerations

It is highly recommended to use SSL/TLS encryption (HTTPS) for secure communication between clients and the CDN server. Change the default username and password in the main.go file to strong and secure credentials. Consider implementing additional security measures based on your specific requirements.

License

This project is licensed under the GPL3 License. See the LICENSE file for details.