Telegraph-Image-Hosting

Build a free image hosting with Telegraph

中文 document is no longer maintained

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.

Deploy the Web Site (Optional)

Please excuse the fact that I can't write a front-end, so the front-end is very minimal. If you have written a nice front-end, please submit a Pull Request and I will appreciate it.

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

cd /www/wwwroot/xxx.com

2. Download the source code on GitHub with Git.

git clone https://github.com/missuo/Telegraph-Image-Hosting.git ./

3. Move all the files in web directory to web root directory.

mv web/* ./

4. Modify the line 34 to your domain in api.php

5. Have fun.

Finally

There is no guarantee that it will work all the time, after all, Telegraph is on the GFW list. Use it and cherish it!

LICENSE

MIT License