1. Deploy sebuah container

Kami menyediakan file docker-compose yang membantu Anda men-deploy container. Pertama, unduh docker-compose.yml, lalu tulis konfigurasi bridge Anda ke sebuah file baru, .env, yang berada di direktori yang sama dengan docker-compose.yml. Berikut sebuah templat:

# Port Tor bridge Anda.
OR_PORT=X
# Port obfs4 bridge Anda.
PT_PORT=Y
# Alamat email Anda.
EMAIL=Z

Ganti X dengan OR port yang Anda inginkan, Y dengan port obfs4 Anda (pastikan kedua port diteruskan pada firewall Anda), dan Z dengan alamat email Anda, yang memungkinkan kami menghubungi Anda jika ada masalah dengan bridge Anda. Dengan konfigurasi bridge Anda sudah siap, kini Anda dapat men-deploy container dengan menjalankan:

docker-compose up -d obfs4-bridge

Perintah ini akan secara otomatis memuat file docker-compose.yml Anda sambil mempertimbangkan variabel lingkungan di .env.

Anda sekarang seharusnya melihat output yang mirip dengan berikut ini:

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

Selesai! Container Anda sekarang sedang melakukan bootstrap bridge obfs4 baru Anda.

2. Upgrade container Anda

Meng-upgrade ke versi terbaru dari image kami semudah menarik versi terbaru dari image yang sedang berjalan dengan menjalankan:

docker-compose pull obfs4-bridge

Dan kemudian me-restart container:

docker-compose up -d obfs4-bridge

Perhatikan bahwa direktori data bridge Anda (yang mencakup materi kuncinya) disimpan dalam docker volume, sehingga Anda tidak akan kehilangan identitas bridge Anda saat melakukan upgrade ke image docker terbaru. Jika Anda menjalankan beberapa bridge pada komputer Anda, Anda perlu mengulangi langkah ini untuk tiap bridge. Kami akan mengumumkan versi image baru di milis tor-dev.

3. Pantau log Anda

Anda dapat memeriksa log bridge Anda dengan menjalankan:

docker logs CONTAINER_ID

Untuk menggunakan bridge baru Anda di Tor Browser, Anda memerlukan "bridge line"-nya. Berikut cara mendapatkan bridge line Anda:

docker exec CONTAINER_ID get-bridge-line

Ini akan mengembalikan string yang mirip dengan berikut ini:

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

Jika Anda mengalami kesulitan menyiapkan bridge, lihat bagian bantuan kami. Jika bridge Anda sekarang sudah berjalan, lihat catatan pasca-instalasi.

4. Penggunaan lanjutan

Anda dapat menyetel variabel torrc tambahan di file .env Anda dengan menyetel OBFS4_ENABLE_ADDITIONAL_VARIABLES ke 1 dan menambahkan awalan OBFS4V_ pada opsi torrc yang diinginkan. Sebagai contoh, untuk menyetel opsi AddressDisableIPv6, sertakan baris berikut di .env Anda:

OBFS4_ENABLE_ADDITIONAL_VARIABLES=1
OBFS4V_AddressDisableIPv6=1

Anda dapat mengunduh templat .env kami untuk memulai.