On-Premises

Cara kerjanya

HopToDesk menggunakan dua jenis server. Server sinyal membantu perangkat saling menemukan dan membuka sesi. Relay TURN membawa lalu lintas sesi hanya ketika koneksi langsung antara kedua perangkat tidak memungkinkan.

Sesi dienkripsi ujung ke ujung, sehingga tidak ada server yang dapat membaca layar, berkas, atau obrolan Anda. Server sinyal hanya melihat ID perangkat dan permintaan koneksi.

Pemasang di halaman ini menyiapkan server sinyal. Lalu lintas relay secara bawaan melewati relay HopToDesk, atau melalui server TURN Anda sendiri jika Anda menyediakannya.

Perangkat di jaringan yang dihosting sendiri tetap dapat ditautkan ke dasbor untuk pengelolaan, dan dasbor dapat mengirimkan pengaturan jaringan kepadanya.

Perlu dasbor di server Anda sendiri juga? Bicara dengan kami

Sebelum memulai

• Server Linux 64-bit dengan systemd, seperti Ubuntu atau Debian, atau server Windows.
• Akses root atau sudo di server tersebut.
• Alamat IP atau nama host yang dapat dijangkau semua perangkat Anda. Untuk jaringan yang tidak pernah keluar dari LAN Anda, alamat privat sudah cukup.
• Port TCP 80 terbuka di firewall server untuk perangkat Anda.
• Jika Anda ingin relay sendiri: host, port, nama pengguna, dan kata sandi server TURN Anda.

Langkah 1: Pasang server sinyal di Linux

1. Masuk ke server sebagai root, atau sebagai pengguna dengan hak sudo.
2. Di bagian atas halaman ini, pilih LAN + Default Relay atau Custom TURN Server. Perintah instalasi berubah sesuai pilihan Anda.
3. Klik Copy, tempel perintah ke terminal, lalu tekan Enter.
4. Tunggu hingga skrip selesai. Prosesnya kurang dari satu menit.
5. Di akhir, skrip mencetak HopSignal Setup Complete, diikuti alamat server Anda dan blok pengaturan jaringan yang siap pakai. Simpan keluaran itu, Anda membutuhkannya di langkah 3.

curl -o hsinstall.sh -sL https://www.hoptodesk.com/hs/hsinstall && sudo sh hsinstall.sh

Dengan server TURN Anda sendiri, tambahkan empat nilainya di akhir perintah dalam urutan ini: host, port, nama pengguna, kata sandi.

sudo sh hsinstall.sh turn.example.com 443 myuser mypassword

Apa yang dilakukan skrip

• Mengunduh server sinyal untuk prosesor Anda, Intel, AMD, atau ARM, ke folder /home/hopsignal.
• Memeriksa unduhan terhadap daftar SHA256SUMS yang dipublikasikan dan berhenti tanpa perubahan jika tidak cocok.
• Membuat layanan systemd bernama hopsignal dan menjalankannya di setiap boot.
• Menjalankan server dengan batas koneksi yang direkomendasikan dan kata sandi federasi acak, disimpan di /home/hopsignal/hopsignal.env dengan akses hanya untuk root.
• Menambahkan pengawas cron yang memulai ulang layanan jika berhenti merespons, dan merotasi log saat ukurannya melewati 100 MB.
• Membuka port TCP 80 di ufw saat ufw aktif.

Langkah 1 di Windows: Jalankan server sinyal

1. Geser sakelar OS di bagian atas halaman ini ke Windows dan klik Download. Anda mendapatkan satu berkas bernama hopsignal.exe.
2. Buat folder seperti C:\hopsignal dan pindahkan hopsignal.exe ke dalamnya.
3. Di folder yang sama, buat berkas teks kosong bernama fedlist.txt.
4. Buka Command Prompt sebagai administrator dan jalankan server.

cd C:\hopsignal
for /f %i in ('powershell -NoProfile -Command "[guid]::NewGuid().ToString('N')"') do @(setx /M FEDPWD %i >nul & set FEDPWD=%i)
hopsignal.exe --ADDR 0.0.0.0:80 --FEDLIST fedlist.txt --FEDADDR 127.0.0.1:82 --LOGFILE hs.log

Baris kedua menyimpan kata sandi federasi acak sebagai pengaturan sistem Windows, sehingga tidak pernah muncul di baris perintah server.

Izinkan port di Windows Firewall:

netsh advfirewall firewall add rule name="HopSignal" dir=in action=allow protocol=TCP localport=80

Agar server tetap berjalan setelah reboot, daftarkan sebagai tugas terjadwal yang dimulai saat boot di bawah akun SYSTEM:

schtasks /Create /TN HopSignal /SC ONSTART /RU SYSTEM /TR "C:\hopsignal\hopsignal.exe --ADDR 0.0.0.0:80 --FEDLIST C:\hopsignal\fedlist.txt --FEDADDR 127.0.0.1:82 --LOGFILE C:\hopsignal\hs.log"
schtasks /Run /TN HopSignal

Langkah 1 dengan Docker: Jalankan server sinyal di dalam container

Image hoptodesk/hopsignal menjalankan server sinyal yang sama di host Intel, AMD, dan ARM. Jalankan dengan batas yang direkomendasikan:

docker run -d --name hopsignal --restart unless-stopped -p 80:80 \
  -e HS_MAX_MESSAGE_KB=64 -e HS_QUEUE_LIMIT=256 -e HS_MAX_CONNS=20000 \
  -e HS_CONNS_PER_IP=100 -e HS_LOOKUPS_PER_IP=20 \
  -e HS_IDLE_TIMEOUT=300 -e HS_UPGRADE_TIMEOUT=10 \
  hoptodesk/hopsignal

Setiap nilai HS_ mengaktifkan satu batas: ukuran pesan dalam KB, pesan antrean per koneksi, koneksi terbuka, koneksi baru dan pencarian per alamat setiap detik, detik idle, dan detik handshake. Jika nilai tidak diisi, batas itu tetap nonaktif.

Untuk menautkan kontainer ke akun dasbor Anda secara otomatis, gunakan perintah Docker dari Set up a private network di dasbor. Perintah itu menambahkan HS_SETUP_TOKEN dan HS_DASHBOARD_URL, dan server melaporkan alamatnya sekali, saat pertama kali mulai.

Langkah 2: Periksa bahwa server berjalan

Di Linux, periksa layanan dan log:

sudo systemctl status hopsignal
tail /home/hopsignal/hs.log

Di Windows, pastikan port sedang mendengarkan:

netstat -an | find ":80 "

Dengan Docker, periksa container dan lognya:

docker ps --filter name=hopsignal
docker logs hopsignal

Dari komputer mana pun, uji port WebSocket. Ganti SERVER_IP dengan alamat server Anda. Server yang sehat menjawab HTTP/1.1 101 Switching Protocols.

curl -i -N -m 5 -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Sec-WebSocket-Version: 13" -H "Sec-WebSocket-Key: SGVsbG8sIHdvcmxkIQ==" http://SERVER_IP:80/

Langkah 3: Arahkan perangkat Anda ke server

Setiap perangkat membaca pengaturan jaringannya dari dokumen JSON kecil. Ini adalah blok yang dicetak pemasang di akhir langkah 1. Ganti SERVER_IP dengan alamat server Anda, dan isi blok TURN jika Anda menjalankan relay sendiri.

{
  "turnservers": [
    {
      "protocol": "turn",
      "host": "turn.hoptodesk.com",
      "port": "443",
      "username": "hoptodesk",
      "password": "hoptodesk1234"
    }
  ],
  "rendezvous": {
    "host": "SERVER_IP",
    "port": "80"
  },
  "winversion": "1.0.0",
  "macversion": "1.0.0",
  "linuxversion": "1.0.0",
  "none": "none"
}

Blok rendezvous adalah server sinyal Anda. Gunakan kunci rendezvousssl alih-alih rendezvous saat server dijangkau melalui TLS, misalnya Cloudflare Worker. Daftar turnservers berisi satu atau lebih relay. Atur protokol ke turn untuk koneksi biasa atau turn-tls untuk koneksi TLS. Biarkan kunci versi apa adanya.

Tulis setiap nomor port di dalam tanda kutip, seperti pada contoh di atas. Aplikasi mengabaikan port yang ditulis sebagai angka biasa.

Ada tiga cara untuk memberikan dokumen ini ke perangkat Anda. Pilih yang sesuai dengan penyiapan Anda.

Opsi A: Letakkan berkas api.json di setiap perangkat

Simpan dokumen sebagai berkas bernama api.json di folder konfigurasi HopToDesk, lalu mulai ulang HopToDesk. Aplikasi membaca berkas saat dijalankan dan tidak lagi menghubungi API HopToDesk.

Di Linux, letakkan salinan kedua di /root/.config/hoptodesk. Aplikasi menggunakan salinan itu di layar masuk, sebelum pengguna masuk.

Opsi B: Hosting berkas di sebuah URL dan pilih di aplikasi

1. Unggah api.json ke server web mana pun yang dapat dijangkau perangkat Anda. HTTPS disarankan.
2. Di HopToDesk, klik ikon roda gigi untuk membuka Pengaturan.
3. Di bawah Network, klik Choose Network.
4. Pilih Custom Network Settings, tempel URL berkas Anda, lalu konfirmasi.
5. HopToDesk mengunduh berkas, memeriksa bahwa berkas berisi entri rendezvous yang valid dan daftar turnservers, lalu terhubung kembali melalui server Anda.

Untuk kembali ke jaringan publik, buka Choose Network lagi dan pilih HopToDesk Network (Default).

Di Android dan iOS, buka Pengaturan, matikan Use HopToDesk Network di bagian Jaringan, lalu masukkan URL berkas Anda. Ponsel yang dikelola melalui EMM dapat menerima URL yang sama lewat pengaturan terkelola custom_api_url.

Opsi C: Kirim pengaturan dari dasbor

Jika perangkat Anda tertaut ke dasbor HopToDesk, Anda dapat mengatur jaringan sekali untuk seluruh akun. Klien kustom yang dibangun dari dasbor sudah membawa pengaturan ini di dalamnya.

Server baru: di dasbor, buka Pengaturan, Network Settings, Set up a private network. Pilih In my AWS account atau On my own server. Server melaporkan alamatnya saat mulai, dan setiap perangkat yang tertaut menerima pengaturan. Tidak ada yang perlu diketik.

Server yang sudah Anda jalankan: masukkan pengaturannya secara manual.

1. Masuk ke dasbor sebagai pemilik atau admin dan buka Pengaturan.
2. Di bawah Network Settings, pilih Custom Network.
3. Masukkan host server sinyal, portnya, dan WS sebagai protokol. Tambahkan server TURN jika Anda menjalankan relay sendiri, atau biarkan kosong untuk tetap memakai relay HopToDesk.
4. Klik Save Network Settings. Setiap perangkat yang tertaut menerima pengaturan baru dan menerapkannya tanpa instal ulang.

Jalankan relay TURN Anda sendiri (opsional)

Sesi yang tidak dapat terhubung langsung secara bawaan dilewatkan melalui relay HopToDesk. Untuk menjaga semua lalu lintas di infrastruktur Anda sendiri, jalankan server TURN. Server TURN standar apa pun dapat dipakai, dan coturn adalah pilihan umum di Linux.

1. Pasang coturn di server relay.

sudo apt install coturn

2. Edit /etc/turnserver.conf dan atur setidaknya nilai-nilai di bawah ini. Ganti realm, kredensial, dan IP publik dengan milik Anda.

listening-port=443
fingerprint
lt-cred-mech
user=myuser:mypassword
realm=example.com
external-ip=PUBLIC_IP

3. Jika /etc/default/coturn berisi baris TURNSERVER_ENABLED, hapus tanda komentarnya. Lalu aktifkan dan jalankan layanannya.

sudo systemctl enable --now coturn
sudo systemctl restart coturn

4. Buka port pendengar untuk TCP dan UDP, ditambah rentang relay UDP 49152 hingga 65535, di firewall relay.
5. Berikan relay ke perangkat Anda: jalankan pemasang lagi dengan empat nilai TURN, atau edit blok turnservers di pengaturan jaringan Anda. Gunakan turn-tls sebagai protokol jika relay Anda menangani TLS.

Mengelola server di Linux

sudo systemctl status hopsignal
sudo systemctl restart hopsignal
sudo systemctl stop hopsignal
tail -f /home/hopsignal/hs.log

Untuk memperbarui server, hentikan layanan dan jalankan perintah instalasi lagi. Perintah itu mengunduh biner terbaru dan menulis ulang layanan.

Untuk menghapus server beserta layanan dan entri cron-nya:

curl -o hsinstall.sh -sL https://www.hoptodesk.com/hs/hsinstall && sudo sh hsinstall.sh remove

Pemecahan masalah

• ID tetap di Generating, atau aplikasi terus mencoba terhubung ke jaringan: perangkat tidak dapat menjangkau server sinyal. Periksa bahwa layanan berjalan, port 80 terbuka, dan alamat di pengaturan jaringan Anda benar.
• Perangkat terhubung di LAN tetapi tidak dari luar: relay tidak dapat dijangkau. Dengan relay bawaan, perangkat memerlukan akses keluar ke turn.hoptodesk.com pada port 443. Dengan relay Anda sendiri, periksa aturan firewall dan kredensialnya.
• Aplikasi mengabaikan api.json: pastikan berkas adalah JSON yang valid tanpa koma di akhir, berada di folder yang benar, dan Anda telah memulai ulang HopToDesk. Log aplikasi berisi baris Loaded local api.json ketika berkas berhasil dibaca.
• Port 82 adalah port federasi untuk menghubungkan beberapa server sinyal milik Anda. Jaga agar tetap tertutup dari internet.
• Server sinyal tidak menyimpan data sesi. Jika ada yang tampak macet, mulai ulang layanannya. Perangkat terhubung kembali dengan sendirinya dalam waktu sekitar satu menit.