Github Pages does not work in China
Github Pages does not work in China

TLDR; This Github Pages’ China article provides a simple solution to get your Github Pages’ powered websites fast, stable, and compliant in China.


What are Github Pages?

Github Pages are a feature provided by GitHub for hosting static sites. Submit static sites to Github’s <USERNAME>.github.io code repository, and Github will help you host the site with the same name as the access address.


Are Github Pages slow in China?

Yes, although Github Pages are not blocked in China, Github Pages are slow and unstable in mainland China in general. (I believe that’s why you are here, you want to make your Github Pages load fast and stable in China with my solution, right below).


Before vs. After Speed Increase

Let’s show you the result first, and then I’ll walk you thru how to do it quickly.

LEFT: Speed test report of the site deployed on Github Pages; RIGHT: Speed test report after speeding up. The color: Green = Fast, Red = Slow, or even inaccessible.
LEFT: Speed test report of the site deployed on Github Pages; RIGHT: Speed test report after speeding up. The color: Green = Fast, Red = Slow, or even inaccessible.

LEFT: Speed test report of the site deployed on Github Pages; RIGHT: Speed test report after speeding up. The color: Green = Fast, Red = Slow, or even inaccessible.

You can see that the access speed of the site deployed on Github Pages in China is very unsatisfactory (LEFT).

It means people in major cities in China like Shanghai, Beijing, Shenzhen, and Guangzhou will have a hard time just opening up your site hosted with Github Pages.

After speeding up, the result is clearly (all green) better. So if you like the result, let’s see how to do it yourself.

Make your web app performs 10x faster in China.

Get started now, and our staff will assist your journey in China.

Get Started Now


How to Improve Github Pages’ Access Speed in China?

The traditional ways:

  1. Get your site hosted on a VPS (Virtual private server) in China.

  2. Host your site on AWS China S3 or Aliyun OSS

The disadvantages of deploying sites with these options are obvious: a lot of leg work needs to be done to get a static site up live in China.

And while hosting your site with these options, you also need to go thru the ICP Filing in China to enable ports 80/443 to get a custom domain working in China. There is an easier way to do it. Read more below:


4 Steps to Get your Github Pages live in China with 21YunBox


1. Get an account on 21YunBox

2. Authorize 21YunBox’s build bot to access your code repo

3. Configure the Build Command and Publish Directory

(If you are not sure how to do it, we’ll show you how to do it right, don’t worry about it for now.)

The Build Command and Publish Directory for a Hexo site with 21YB
The Build Command and Publish Directory for a Hexo site with 21YB

4. Click the “deploy” button

Our build bot will deploy your site in China in a couple of seconds. Once it’s done deploying, you can access your Github pages on a given 21YB domain and maybe configure your custom domain if needed.


Need help getting your tech stack to work in China?

21YunBox, a cross-border company, has worked with several fortune 500 enterprises and offices in the U.S. and Shanghai. We can assist you in every phase of your china hosting strategy to make your video, website, and content delivery in China at the best speed and advise you on the best channels to promote your business in China.

Contact us today, and our experts will explain to you all the secrets of making your site live in China!



Ready to make your app work in China?

Get Started Questions? Talk to an expert.