README.md

Telegraph-Image-Hosting

Build a free image hosting with Telegraph

Important

Starting from September 6, 2024, Telegram officially discontinued the upload feature of Telegraph, rendering this project no longer functional.

Alternatives

• https://github.com/missuo/discord-image

This project should be able to perfectly replace Telegraph.

Features

• Free
• Unlimited bandwidth (It will consume the traffic of your VPS)
• No censorship (NSFW image can be uploaded)
• You can upload any file, not just image files

Disadvantages

• Single file cannot exceed 5MB
• Access speed may not be ideal in China Mainland

Current Strategy (Recommended)

Full enable HTTPS

Client -> Cloudflare Server (Optional) -> Your VPS (Example: Oracle Cloud) -> Telegraph Servers (NL) 

Demo Site

missuo.ru

Deployment

Preparation

• a Domain (Make sure it's not blocked by GFW)
• an overseas VPS (Make sure you can access Telegraph)
• Install Nginx

Configure Nginx

I don't talk too much about simple steps such as domain name resolution and SSL certificate application.

location /upload {
            add_header Access-Control-Allow-Origin *;
            add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS';
            add_header Access-Control-Allow-Headers 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization';
            if ($request_method = 'OPTIONS') {
                return 204;}
            proxy_pass https://telegra.ph/upload;
}
location /file {
            proxy_pass https://telegra.ph/file;
}

client_max_body_size 5m;

Note: Remove all other useless location related configuration and just keep the two above.

With uPic for macOS/iOS

Thanks to my best friend Svend (author of uPic) for guiding the configuration scheme

1. You can change the API URL and Domain to your own.

2. Don't forget to click on the Other fields to add the header information.

1. Connect your server by SSH, then enter your web directory.

cd /www/wwwroot/xxx.com

2. Download the source code on GitHub with wget.

wget https://raw.githubusercontent.com/missuo/Telegraph-Image-Hosting/main/index.html

3. Modify the API https://missuo.ru/upload to your domain.

4. Have fun.

Finally

There is no guarantee that the Telegraph will work all the time, as it is on the GFW list. However, when you can use it, make sure to cherish it!

Author

Telegraph-Image-Hosting © Vincent Young, Released under the MIT License.