Deploy a Fixie SOCKS proxy on Koyeb
Learn more about Koyeb
·
Explore the documentation
·
Discover our tutorials
Koyeb is a developer-friendly serverless platform to deploy apps globally. No-ops, servers, or infrastructure management. This repository contains a Fixie SOCKS proxy example application you can deploy on the Koyeb serverless platform for testing.
This example application is designed to show how an application can use Fixie to connect to IP-restricted resources via a SOCKS proxy. The application proxies requests from a local port to World Clock API. This same strategy can be used to connect to remote databases and other resources where you wish to configure IP address based access restrictions.
Follow the steps below to deploy and run the Fixie SOCKS proxy application on your Koyeb account.
You need a Koyeb account to successfully deploy and run this application. If you don't already have an account, you can sign-up for free here.
You also need a Fixie account with a SOCKS proxy configured. You will need the Proxy URL for your SOCKS proxy.
The fastest way to deploy the Fixie SOCKS proxy application is to click the Deploy to Koyeb button below.
Clicking on this button brings you to the Koyeb App creation page with everything pre-set to launch this application. Edit the value of the FIXIE_SOCKS_HOST environment variable to match the Proxy URL for your SOCKS proxy before deploying.
To modify this application example, you will need to fork this repository. Checkout the fork and deploy instructions.
If you want to customize and enhance this application, you need to fork this repository.
If you used the Deploy to Koyeb button, you can simply link your service to your forked repository to be able to push changes. Alternatively, you can manually create the application as described below.
On the Koyeb Control Panel, on the Overview tab, click the Create Web Service button to begin.
- Select GitHub as the deployment method.
- In the repositories list, select the repository you just forked.
- Select your preferred region and Instance type.
- In the Environment variables section, add a variable named
FIXIE_SOCKS_HOST. Set its value to the Proxy URL you copied from your Fixie SOCKS proxy page. - Choose a name for your Service, i.e
fixie-on-koyeb, and click Deploy.
You will be taken to the deployment page where you can follow the build of the Fixie proxy application. Once the build is completed, your application will be deployed and you will be able to access it via the Koyeb public URL.
If you have any questions, ideas or suggestions regarding this application sample, feel free to open an issue or fork this repository and open a pull request.