Skip to main content

Furion Socks5 SSL Proxy

Furion is an encrypted proxy written in Python. In essence, it's just socks5 server with ssl support. It's often used with upstream Furion servers to avoid censorship.

Features

  • Automatic upstream fail over (when multiple upstream servers are available).
  • Built-in latency check for choosing the fastest upstream.
  • Periodical upstream updates from a designated central registry.
  • Builtin DNS server/proxy to avoid poisoning.
  • Limit what ports that clients are allowed to connect to.
  • Easy account management on the server side.

Dependencies

Furion has no external dependencies other than a standard Python 3.x (>=3.7) installation. There is optional support for gevent, which would be used if an existing gevent installation was discovered.

Installation

Furion can be installed via pip:

pip install furion

or pipx

pipx install furion

To start using Furion, you need at least a furion.cfg file.

By default, Furion will look for furion.cfg and upstream.json in /etc/furion or the current working directory. You can specify path to the configuration file after a -c switch.

For client, an upstream.json file is also needed for upstream checking to work in the same directory your furion.cfg resides in.

Alternatively, you can put the upstream.json file somewhere accessible via http, so that you can share that address with your friends. Then configure the upstream section of your furion.cfg file like below, to use that upstream file.

[upstream]

central_url = http://your.upstream.json

autoupdate_upstream_list = on

update_frequency = start

upstream_list_path = upstream.json

Read configuration files in examples directory for more information.

Building Standalone Windows Clients

  • Install miniconda3
winget install miniconda3
  • Create a new conda environment
conda create -n furion
  • Activate the environment
conda activate furion
  • Install pyinstaller
conda install -c conda-forge pyinstaller
  • Install wxPython (optional if you only want to build the cli version)
conda install -c conda-forge wxpython
  • Install furion itself
cd furion
pip install -e .
  • Build the standalone client
cd scripts/pyinstaller
pyinstaller.bat
  • The standalone clients will be in dist/furion.exe and dist/furion-cli.exe
  • Furion.exe is only a tray icon currently.

Note: You need to put a config file furion.cfg in the same directory of the exe for it to work.

Release files for furion 1.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for furion 1.5.3
File Size Uploaded
furion-1.5.3.tar.gz 77.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for furion 1.5.3
File Interpreter ABI Platform
furion-1.5.3-py3-none-any.whl Python 3 none any Details

Total release size: 92.7 kB

Release files / furion-1.5.3.tar.gz

Download URL furion-1.5.3.tar.gz
Size 77.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a414a47727a0a0db2b374093e25cdc67d0308dc9d4289c274bc2792a6411b427
BLAKE2b-256 checksum
How to use checksums
2af382b8c47b847f7049899df328256363d18edcd4faeb2c2c707f818288d24b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.3

Release files / furion-1.5.3-py3-none-any.whl

Download URL furion-1.5.3-py3-none-any.whl
Size 14.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0373de54741a24b9183ed76e6458d3301778ffa8c9e3d8181ad5b22123d24f97
BLAKE2b-256 checksum
How to use checksums
59e0b6b02b61e1329b45cb62628763c4c9a7d0b3d901dd0e671f68de4f51a287
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.3

Release history Release notifications | RSS feed

This release

1.5.3 This release

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.9

2 release files

1.4.8

2 release files

1.4.7

2 release files

1.4.6

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page