Skip to content
Github Pages alike for private repository
TypeScript HTML JavaScript Shell Makefile Dockerfile CSS
Branch: master
Clone or download
Pull request Compare This branch is 9 commits ahead of shadow-paw:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.k8s
server
.gitignore
.travis.yml
LICENSE
README.md

README.md

gh-html TravisCI

Github Pages alike for private repository

Github Pages is very useful to host html-based project and auto-generated document. However it lacks access control, which becomes a concern for projects under private repository, which you don't want anything go public. On the other hand, for security reason raw.githubusercontent.com returns everything as plain/text, rendering it not veryuseful for trusted content.

gh-html aims to resolve this and provide an OAuth proxy to access to your github repository, which is particular useful for:

  1. Previewing html directly hosted on github.
  2. Have CI generate document and push on a particular branch, and enable you to view it.

Github OAuth App

The server proxy files on github on your behalf, to do so it uses the github OAuth API and require an app registry on github. You need to create an OAuth App entry on https://github.com/settings/developers and setup the Authorization callback URL to match your server.
The URL shall be $APP_SERVER_BASE/auth/github, e.g. https://www.example.com/gh-html/auth/github.

Initial Configuration

cd server
# generate secrets
make secret-reset
# adjust settings like github app id
vi .env

Follow the comment in file for configuration detail.

Running

Run as standalone

The server is written as typescript and run with node.js. It also connect to a redis server for session store.
To run as standalone you need to setup a redis server.

cd server
npm install
make run

Run with docker

The server is written as typescript and run with node.js. It also connect to a redis server for session store.
The docker-compose.yml setup these two images.

cd server
docker-compose build
docker-compose up -d

Security Disclaimer

gh-html is intended for use with trusted content, while having standard practice in mind, the mechanism that it proxy multiple repositories under same URL means things like cookies are shared. It should not be used to preview untrusted or random public content. Doing so might put you at certain security risk, or the computer would just explode.
To preview public repository just visit https://htmlpreview.github.io/

You can’t perform that action at this time.