1. Deploy a container

We provide a docker-compose file that helps you deploy the container. First, download docker-compose.yml, and then write your bridge configuration to a new file, .env, which is in the same directory as docker-compose.yml. Here's a template:

# درگاه پل تور شما.
OR_PORT=X
# درگاه obfs4 پل شما.
PT_PORT=Y
# آدرس ایمیل شما.
EMAIL=Z

X را با درگاه OR دلخواه خود و Y را با درگاه obfs4 خود (مطمئن شوید که هر دو درگاه در دیوار آتش شما باز هستند)، و Z را با نشانی ایمیل خود جایگزین کنید که به ما اجازه می دهد در صورت وجود مشکل با پل شما با شما ارتباط برقرار کنیم. With your bridge configuration in place, you can now deploy the container by running:

docker-compose up -d obfs4-bridge

This command will automatically load your docker-compose.yml file while considering the environment variables in .env.

خروجی باید چیزی شبیه به این باشد:

Starting docker-obfs4-bridge_obfs4-bridge_1 ... done

That's it! Your container is now bootstrapping your new obfs4 bridge.

2. Upgrade your container

Upgrading to the latest version of our image is as simple as pulling the latest version of the image running:

docker-compose pull obfs4-bridge

And then restarting the container:

docker-compose up -d obfs4-bridge

توجه داشته باشید که دایرکتوری داده پل شما (که دارای محتوای کلیدی خود می باشد) در یک حجم داکر ذخیره شده است بنابراین هویت پل خود را در هنگام ارتقا به آخرین تصویر داکر از دست نخواهید داد. اگر در حال اجرا چندین پل روی کامپیوتر خود هستید، باید این مرحله را برای هر پل تکرار کنید. ما نسخه های جدید تصویر را روی لیست ‌پست‌سپاری tor-dev اعلام می کنیم.

3. Monitor your logs

می توانید لاگ های پل خود را اجرای این دستور بررسی کنید:

docker logs CONTAINER_ID

برای استفاده از پل جدید خود در مرورگر تور، باید "خط پل" آن را داشته باشید. این نحوه گرفتن خط پل می باشد:

docker exec CONTAINER_ID get-bridge-line

این یک رشته مشابه به این تحویل خواهد داد:

obfs4 1.2.3.4:1234 B0E566C9031657EA7ED3FC9D248E8AC4F37635A4 cert=OYWq67L7MDApdJCctUAF7rX8LHvMxvIBPHOoAp0+YXzlQdsxhw6EapaMNwbbGICkpY8CPQ iat-mode=0

If you are having trouble setting up your bridge, have a look at our help section. If your bridge is now running, check out the post-install notes.

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 to get started.