# How to circumvent censorship with little-t tor?

Windows
macOS
گنو/لینوکس

Attention: These instructions are meant for using pluggable transports with tor, the network daemon i.e. little-t tor. For instructions on using pluggable transports with Tor Browser, refer to the Tor Browser user manual.

دسترسی مستقیم به شبکهٔ Tor ممکن است گاهی مسدود شده باشد. Tor can be used with circumvention tools, known as pluggable transports, for getting around these blocks. obfs4, Snowflake and WebTunnel are some pluggable transports available to use with Tor. Tor can be configured to use pluggable transports by modifying Tor's configuration file i.e. torrc.

مراحل برای پیکربندی `tor` برای استفاده از حامل‌های انتقال‌پذیر در سیستم‌عامل‌های مختلف در ادامه آمده‌اند.

1. Download and install `tor` or the Tor Expert Bundle for Windows. If access to the Tor Project website is blocked, use an official Tor Project mirror.
2. If you have `tor` installed, the pluggable transport binary, lyrebird, can be downloaded as part of the Tor Expert Bundle. `lyrebird` چندین حامل انتقال‌پذیر را پیاده‌سازی می‌کند، از جمله obfs4،‏ Snowflake و WebTunnel.
3. Extract the Tor Expert Bundle to a directory of your choice.
4. For pluggable transports, obfs4 and WebTunnel, obtain bridges from the bridges website, via Email or via Telegram.
5. Modify Tor's configuration file, i.e. torrc.
6. Copy and modify the following sample `torrc`.

#### پیکربندی `tor` برای استفاده از obfs4،‏ Snowflake یا WebTunnel

`torrc` example:

    UseBridges 1
    # Please review the path to the pluggable transport executable
    ClientTransportPlugin meek_lite,obfs4,snowflake,webtunnel exec C:\Users\user\Downloads\tor\pluggable_transports\lyrebird.exe
    # Uncomment the line below depending to the type of bridge your are using
    #Bridge obfs4 <IP ADDRESS>:<PORT> <FINGERPRINT> cert=<CERTIFICATE> iat-mode=0
    #Bridge webtunnel <IP ADDRESS>:<PORT> <FINGERPRINT> url=<URL> ver=0.0.1
    #Bridge snowflake 192.0.2.3:80 2B280B23E1107BB62ABFC40DDCC8824814F80A72 fingerprint=2B280B23E1107BB62ABFC40DDCC8824814F80A72 url=https://1098762253.rsc.cdn77.org front=www.phpmyadmin.net,cdn.zk.mk ice=stun:stun.antisip.com:3478,stun:stun.epygi.com:3478,stun:stun.uls.co.za:3478,stun:stun.voipgate.com:3478,stun:stun.mixvoip.com:3478,stun:stun.nextcloud.com:3478,stun:stun.bethesda.net:3478,stun:stun.nextcloud.com:443 utls-imitate=hellorandomizedalpn

Now save the `torrc` file and run from the command line:

./tor -f torrc

#### رفع مشکل

- اگر اتصال Tor ناموفق بود، بررسی کنید تا فایل `torrc` به‌درستی قالب‌بندی شده باشد.
- اگر `tor` را از بستهٔ نرم‌افزاری پیشرفتهٔ Tor نصب کرده‌اید، مطمئن شوید که فایل `torrc` در همان پوشه‌ای است که فایل دودویی `tor` در آن قرار دارد.
- Check the Tor logs for errors.
- اگر پس از اجرای مراحل رایج رفع مشکل، اتصال همچنان ناموفق بود، پل‌هایی که دریافت کرده‌اید ممکن است آفلاین یا مسدود شده باشند. مجموعه‌ای جدید از پل‌ها را از سایت پل‌ها، از طریق ایمیل‏ یا تلگرام‏ دریافت کنید.

Attention: These instructions are meant for using pluggable transports with tor, the network daemon i.e. little-t tor. For instructions on using pluggable transports with Tor Browser, refer to the Tor Browser user manual.

دسترسی مستقیم به شبکهٔ Tor ممکن است گاهی مسدود شده باشد. Tor can be used with circumvention tools, known as pluggable transports, for getting around these blocks. obfs4, Snowflake and WebTunnel are some pluggable transports available to use with Tor. Tor can be configured to use pluggable transports by modifying Tor's configuration file i.e. torrc.

مراحل برای پیکربندی `tor` برای استفاده از حامل‌های انتقال‌پذیر در سیستم‌عامل‌های مختلف در ادامه آمده‌اند.

1. Download and install `tor` or the Tor Expert Bundle for macOS. If access to the Tor Project website is blocked, use an official Tor Project mirror.
2. If you have `tor` installed, the pluggable transport binary, lyrebird, can be downloaded as part of the Tor Expert Bundle. `lyrebird` چندین حامل انتقال‌پذیر را پیاده‌سازی می‌کند، از جمله obfs4،‏ Snowflake و WebTunnel.
3. Extract the Tor Expert Bundle to a directory of your choice.
4. For pluggable transports, obfs4 and WebTunnel, obtain bridges from the bridges website, via Email or via Telegram.
5. Modify Tor's configuration file, i.e. torrc.
6. Copy and modify the following sample `torrc`.

#### پیکربندی `tor` برای استفاده از obfs4،‏ Snowflake یا WebTunnel

`torrc` example:

    UseBridges 1
    # Please review the path to the pluggable transport executable
    ClientTransportPlugin meek_lite,obfs4,snowflake,webtunnel exec /Users/user/Downloads/tor/pluggable_transports/lyrebird
    # Uncomment the line below depending to the type of bridge your are using
    #Bridge obfs4 <IP ADDRESS>:<PORT> <FINGERPRINT> cert=<CERTIFICATE> iat-mode=0
    #Bridge webtunnel <IP ADDRESS>:<PORT> <FINGERPRINT> url=<URL> ver=0.0.1
    #Bridge snowflake 192.0.2.3:80 2B280B23E1107BB62ABFC40DDCC8824814F80A72 fingerprint=2B280B23E1107BB62ABFC40DDCC8824814F80A72 url=https://1098762253.rsc.cdn77.org front=www.phpmyadmin.net,cdn.zk.mk ice=stun:stun.antisip.com:3478,stun:stun.epygi.com:3478,stun:stun.uls.co.za:3478,stun:stun.voipgate.com:3478,stun:stun.mixvoip.com:3478,stun:stun.nextcloud.com:3478,stun:stun.bethesda.net:3478,stun:stun.nextcloud.com:443 utls-imitate=hellorandomizedalpn

Now save the `torrc` file and run from the command line:

./tor -f torrc

#### رفع مشکل

- اگر اتصال Tor ناموفق بود، بررسی کنید تا فایل `torrc` به‌درستی قالب‌بندی شده باشد.
- اگر `tor` را از بستهٔ نرم‌افزاری پیشرفتهٔ Tor نصب کرده‌اید، مطمئن شوید که فایل `torrc` در همان پوشه‌ای است که فایل دودویی `tor` در آن قرار دارد.
- Check the Tor logs for errors.
- اگر پس از اجرای مراحل رایج رفع مشکل، اتصال همچنان ناموفق بود، پل‌هایی که دریافت کرده‌اید ممکن است آفلاین یا مسدود شده باشند. مجموعه‌ای جدید از پل‌ها را از سایت پل‌ها، از طریق ایمیل‏ یا تلگرام‏ دریافت کنید.

Attention: These instructions are meant for using pluggable transports with tor, the network daemon i.e. little-t tor. For instructions on using pluggable transports with Tor Browser, refer to the Tor Browser user manual.

دسترسی مستقیم به شبکهٔ Tor ممکن است گاهی مسدود شده باشد. Tor can be used with circumvention tools, known as pluggable transports, for getting around these blocks. obfs4, Snowflake and WebTunnel are some pluggable transports available to use with Tor. Tor can be configured to use pluggable transports by modifying Tor's configuration file i.e. torrc.

مراحل برای پیکربندی `tor` برای استفاده از حامل‌های انتقال‌پذیر در سیستم‌عامل‌های مختلف در ادامه آمده‌اند.

1. Download and install `tor` or the Tor Expert Bundle for Linux. If access to the Tor Project website is blocked, use an official Tor Project mirror.
2. If you have `tor` installed, the pluggable transport binary, lyrebird, can be downloaded as part of the Tor Expert Bundle. `lyrebird` چندین حامل انتقال‌پذیر را پیاده‌سازی می‌کند، از جمله obfs4،‏ Snowflake و WebTunnel.
3. Extract the Tor Expert Bundle to a directory of your choice.
4. For pluggable transports, obfs4 and WebTunnel, obtain bridges from the bridges website, via Email or via Telegram.
5. Modify Tor's configuration file, i.e. torrc.
6. Copy and modify the following sample `torrc`. If you have installed little-t tor on Linux via your package manager, you will have to modify the default `torrc`.

#### پیکربندی `tor` برای استفاده از obfs4،‏ Snowflake یا WebTunnel

`torrc` example:

    UseBridges 1
    # Please review the path to the pluggable transport executable
    ClientTransportPlugin meek_lite,obfs4,snowflake,webtunnel exec /home/user/Downloads/tor/pluggable_transports/lyrebird
    # Uncomment the line below depending to the type of bridge your are using
    #Bridge obfs4 <IP ADDRESS>:<PORT> <FINGERPRINT> cert=<CERTIFICATE> iat-mode=0
    #Bridge webtunnel <IP ADDRESS>:<PORT> <FINGERPRINT> url=<URL> ver=0.0.1
    #Bridge snowflake 192.0.2.3:80 2B280B23E1107BB62ABFC40DDCC8824814F80A72 fingerprint=2B280B23E1107BB62ABFC40DDCC8824814F80A72 url=https://1098762253.rsc.cdn77.org front=www.phpmyadmin.net,cdn.zk.mk ice=stun:stun.antisip.com:3478,stun:stun.epygi.com:3478,stun:stun.uls.co.za:3478,stun:stun.voipgate.com:3478,stun:stun.mixvoip.com:3478,stun:stun.nextcloud.com:3478,stun:stun.bethesda.net:3478,stun:stun.nextcloud.com:443 utls-imitate=hellorandomizedalpn

Now save the `torrc` file and run from the command line:

./tor -f torrc

- توجه: اگر شما little-t-tor را روی لینوکس از طریق مدیر بسته خود نصب کرده‌اید و `torrc` پیش‌فرض را تغییر داده‌اید، باید برای اعمال تغییرات، سرویس را مجدداً راه‌اندازی کنید.

#### رفع مشکل

- اگر اتصال Tor ناموفق بود، بررسی کنید تا فایل `torrc` به‌درستی قالب‌بندی شده باشد.
- اگر `tor` را از بستهٔ نرم‌افزاری پیشرفتهٔ Tor نصب کرده‌اید، مطمئن شوید که فایل `torrc` در همان پوشه‌ای است که فایل دودویی `tor` در آن قرار دارد.
- Check the Tor logs for errors.
- اگر پس از اجرای مراحل رایج رفع مشکل، اتصال همچنان ناموفق بود، پل‌هایی که دریافت کرده‌اید ممکن است آفلاین یا مسدود شده باشند. مجموعه‌ای جدید از پل‌ها را از سایت پل‌ها، از طریق ایمیل‏ یا تلگرام‏ دریافت کنید.