[tor-commits] [community/master] Add advanced usage instructions for obfs4 docker

gus at torproject.org gus at torproject.org
Mon Apr 12 19:13:05 UTC 2021


commit e1867cb683195a4a41e3a6344a994e247d28c86f
Author: Cecylia Bocovich <cohosh at torproject.org>
Date:   Mon Apr 12 13:10:35 2021 -0400

    Add advanced usage instructions for obfs4 docker
    
    We just merged a contribution that allows users to specify arbitrary
    torrc options for their docker-based obfs4 bridge. This adds
    instructions for how to configure a bridge with these options and a link
    to an example .env file.
---
 .../technical-setup/bridge/docker/contents.lr                 | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/content/relay-operations/technical-setup/bridge/docker/contents.lr b/content/relay-operations/technical-setup/bridge/docker/contents.lr
index aaf89fc..6448ba3 100644
--- a/content/relay-operations/technical-setup/bridge/docker/contents.lr
+++ b/content/relay-operations/technical-setup/bridge/docker/contents.lr
@@ -73,6 +73,17 @@ obfs4 1.2.3.4:1234 B0E566C9031657EA7ED3FC9D248E8AC4F37635A4 cert=OYWq67L7MDApdJC
 Make sure to check out the [post-install notes](https://community.torproject.org/relay/setup/bridge/post-install/).
 If you are having trouble setting up your bridge, have a look at [our help section](https://community.torproject.org/relay/getting-help/).
 
+### 4. Advanced usage
+
+You may set additional torrc variables in your `.env` file by setting `OBFS4_ENABLE_ADDITIONAL_VARIABLES` to 1 and prefixing the desired torrc options with `OBFS4V_`. For example, to set the `AddressDisableIPv6` option, include the following lines in your `.env`:
+
+```
+OBFS4_ENABLE_ADDITIONAL_VARIABLES=1
+OBFS4V_AddressDisableIPv6=1
+```
+
+You may [download our template .env](https://dip.torproject.org/torproject/anti-censorship/docker-obfs4-bridge/raw/master/.env) to get started.
+
 ---
 html: two-columns-page.html
 ---





More information about the tor-commits mailing list