ออนพรีมิส

วิธีการทำงาน

HopToDesk ใช้เซิร์ฟเวอร์สองประเภท เซิร์ฟเวอร์สัญญาณช่วยให้อุปกรณ์ค้นหากันและเริ่มเซสชัน รีเลย์ TURN จะส่งผ่านข้อมูลเซสชันเฉพาะเมื่อไม่สามารถเชื่อมต่อโดยตรงระหว่างอุปกรณ์ทั้งสองได้

เซสชันเข้ารหัสแบบต้นทางถึงปลายทาง เซิร์ฟเวอร์ทั้งสองจึงอ่านหน้าจอ ไฟล์ หรือแชตของคุณไม่ได้ เซิร์ฟเวอร์สัญญาณเห็นเพียง ID อุปกรณ์และคำขอเชื่อมต่อเท่านั้น

ตัวติดตั้งในหน้านี้ตั้งค่าเซิร์ฟเวอร์สัญญาณ ข้อมูลผ่านรีเลย์จะไปที่รีเลย์ของ HopToDesk เป็นค่าเริ่มต้น หรือผ่านเซิร์ฟเวอร์ TURN ของคุณเองหากคุณระบุไว้

อุปกรณ์ในเครือข่ายที่โฮสต์เองยังเชื่อมโยงกับแดชบอร์ดเพื่อการจัดการได้ และแดชบอร์ดสามารถส่งการตั้งค่าเครือข่ายไปยังอุปกรณ์เหล่านั้น

ต้องการให้แดชบอร์ดอยู่บนเซิร์ฟเวอร์ของคุณเองด้วยหรือไม่ พูดคุยกับเรา

ก่อนเริ่มต้น

• เซิร์ฟเวอร์ Linux แบบ 64 บิตที่มี systemd เช่น Ubuntu หรือ Debian หรือเซิร์ฟเวอร์ Windows
• สิทธิ์ root หรือ sudo บนเซิร์ฟเวอร์นั้น
• ที่อยู่ IP หรือชื่อโฮสต์ที่อุปกรณ์ทุกเครื่องของคุณเข้าถึงได้ สำหรับเครือข่ายที่ไม่ออกนอก LAN ของคุณ ที่อยู่ส่วนตัวก็เพียงพอ
• เปิดพอร์ต TCP 80 บนไฟร์วอลล์ของเซิร์ฟเวอร์สำหรับอุปกรณ์ของคุณ
• หากต้องการรีเลย์ของตัวเอง: โฮสต์ พอร์ต ชื่อผู้ใช้ และรหัสผ่านของเซิร์ฟเวอร์ TURN ของคุณ

ขั้นตอนที่ 1: ติดตั้งเซิร์ฟเวอร์สัญญาณบน Linux

1. เข้าสู่ระบบเซิร์ฟเวอร์ในฐานะ root หรือผู้ใช้ที่มีสิทธิ์ sudo
2. ที่ด้านบนของหน้านี้ ให้เลือก LAN + Default Relay หรือ Custom TURN Server คำสั่งติดตั้งจะเปลี่ยนตามตัวเลือกของคุณ
3. คลิก Copy วางคำสั่งลงในเทอร์มินัล แล้วกด Enter
4. รอจนกว่าสคริปต์จะทำงานเสร็จ ใช้เวลาไม่ถึงหนึ่งนาที
5. เมื่อจบ สคริปต์จะแสดง HopSignal Setup Complete ตามด้วยที่อยู่เซิร์ฟเวอร์ของคุณและบล็อกการตั้งค่าเครือข่ายที่พร้อมใช้ เก็บผลลัพธ์นั้นไว้ คุณต้องใช้ในขั้นตอนที่ 3

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

หากใช้เซิร์ฟเวอร์ TURN ของคุณเอง ให้เพิ่มค่าทั้งสี่ต่อท้ายคำสั่งตามลำดับนี้: โฮสต์ พอร์ต ชื่อผู้ใช้ รหัสผ่าน

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

สคริปต์ทำอะไร

• ดาวน์โหลดเซิร์ฟเวอร์สัญญาณสำหรับโปรเซสเซอร์ของคุณ Intel, AMD หรือ ARM ไปยังโฟลเดอร์ /home/hopsignal
• ตรวจสอบไฟล์ที่ดาวน์โหลดกับรายการ SHA256SUMS ที่เผยแพร่ และหยุดโดยไม่เปลี่ยนแปลงใด ๆ หากไม่ตรงกัน
• สร้างบริการ systemd ชื่อ hopsignal และเริ่มทำงานทุกครั้งที่บูต
• เริ่มเซิร์ฟเวอร์ด้วยขีดจำกัดการเชื่อมต่อที่แนะนำและรหัสผ่านสหพันธ์แบบสุ่ม ซึ่งเก็บไว้ใน /home/hopsignal/hopsignal.env โดยให้เฉพาะ root เข้าถึงได้
• เพิ่มตัวเฝ้าระวังใน cron ที่จะรีสตาร์ตบริการเมื่อหยุดตอบสนอง และหมุนเวียนไฟล์บันทึกเมื่อมีขนาดเกิน 100 MB
• เปิดพอร์ต TCP 80 ใน ufw เมื่อ ufw ทำงานอยู่

ขั้นตอนที่ 1 บน Windows: เรียกใช้เซิร์ฟเวอร์สัญญาณ

1. สลับสวิตช์ OS ที่ด้านบนของหน้านี้เป็น Windows แล้วคลิก Download คุณจะได้ไฟล์เดียวชื่อ hopsignal.exe
2. สร้างโฟลเดอร์ เช่น C:\hopsignal แล้วย้าย hopsignal.exe เข้าไป
3. ในโฟลเดอร์เดียวกัน ให้สร้างไฟล์ข้อความว่างชื่อ fedlist.txt
4. เปิด Command Prompt ในฐานะผู้ดูแลระบบแล้วเริ่มเซิร์ฟเวอร์

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

บรรทัดที่สองบันทึกรหัสผ่านสหพันธ์แบบสุ่มเป็นการตั้งค่าระบบของ Windows จึงไม่ปรากฏในบรรทัดคำสั่งของเซิร์ฟเวอร์เลย

อนุญาตพอร์ตใน Windows Firewall:

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

เพื่อให้เซิร์ฟเวอร์ทำงานต่อหลังรีบูต ให้ลงทะเบียนเป็นงานตามกำหนดเวลาที่เริ่มเมื่อบูตภายใต้บัญชี 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

ขั้นตอนที่ 1 ด้วย Docker: เรียกใช้เซิร์ฟเวอร์สัญญาณในคอนเทนเนอร์

อิมเมจ hoptodesk/hopsignal เรียกใช้เซิร์ฟเวอร์สัญญาณตัวเดียวกันบนโฮสต์ Intel, AMD และ ARM เริ่มต้นด้วยขีดจำกัดที่แนะนำ:

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

ค่า HS_ แต่ละค่าเปิดขีดจำกัดหนึ่งรายการ: ขนาดข้อความเป็น KB, ข้อความที่รอคิวต่อการเชื่อมต่อ, การเชื่อมต่อที่เปิดอยู่, การเชื่อมต่อใหม่และการค้นหาต่อที่อยู่ต่อวินาที, วินาทีที่ไม่มีการใช้งาน และวินาทีสำหรับการจับมือ หากไม่ระบุค่าใด ขีดจำกัดนั้นจะยังคงปิดอยู่

หากต้องการเชื่อมโยงคอนเทนเนอร์กับบัญชีแดชบอร์ดของคุณโดยอัตโนมัติ ให้ใช้คำสั่ง Docker จาก Set up a private network ในแดชบอร์ด คำสั่งนี้จะเพิ่ม HS_SETUP_TOKEN และ HS_DASHBOARD_URL และเซิร์ฟเวอร์จะรายงานที่อยู่ของตนหนึ่งครั้งเมื่อเริ่มทำงานครั้งแรก

ขั้นตอนที่ 2: ตรวจสอบว่าเซิร์ฟเวอร์กำลังทำงาน

บน Linux ให้ตรวจสอบบริการและไฟล์บันทึก:

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

บน Windows ให้ยืนยันว่าพอร์ตกำลังรับฟัง:

netstat -an | find ":80 "

หากใช้ Docker ให้ตรวจสอบคอนเทนเนอร์และล็อกของมัน:

docker ps --filter name=hopsignal
docker logs hopsignal

ทดสอบพอร์ต WebSocket จากคอมพิวเตอร์เครื่องใดก็ได้ แทนที่ SERVER_IP ด้วยที่อยู่เซิร์ฟเวอร์ของคุณ เซิร์ฟเวอร์ที่ทำงานปกติจะตอบกลับ 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/

ขั้นตอนที่ 3: ชี้อุปกรณ์ของคุณไปที่เซิร์ฟเวอร์

อุปกรณ์แต่ละเครื่องอ่านการตั้งค่าเครือข่ายจากเอกสาร JSON ขนาดเล็ก นี่คือบล็อกที่ตัวติดตั้งแสดงไว้ตอนท้ายของขั้นตอนที่ 1 แทนที่ SERVER_IP ด้วยที่อยู่เซิร์ฟเวอร์ของคุณ และกรอกบล็อก TURN หากคุณใช้รีเลย์ของตัวเอง

{
  "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"
}

บล็อก rendezvous คือเซิร์ฟเวอร์สัญญาณของคุณ ใช้คีย์ rendezvousssl แทน rendezvous เมื่อเข้าถึงเซิร์ฟเวอร์ผ่าน TLS เช่น Cloudflare Worker รายการ turnservers มีรีเลย์หนึ่งตัวหรือมากกว่า ตั้งโปรโตคอลเป็น turn สำหรับการเชื่อมต่อธรรมดา หรือ turn-tls สำหรับการเชื่อมต่อ TLS ปล่อยคีย์เวอร์ชันไว้ตามเดิม

ให้เขียนหมายเลขพอร์ตทุกตัวไว้ในเครื่องหมายคำพูด ตามตัวอย่างด้านบน แอปจะไม่สนใจพอร์ตที่เขียนเป็นตัวเลขธรรมดา

มีสามวิธีในการส่งเอกสารนี้ให้อุปกรณ์ของคุณ เลือกวิธีที่เหมาะกับการติดตั้งของคุณ

ตัวเลือก A: วางไฟล์ api.json บนอุปกรณ์แต่ละเครื่อง

บันทึกเอกสารเป็นไฟล์ชื่อ api.json ในโฟลเดอร์การกำหนดค่าของ HopToDesk แล้วรีสตาร์ต HopToDesk แอปจะอ่านไฟล์เมื่อเริ่มทำงานและไม่ติดต่อ API ของ HopToDesk อีก

บน Linux ให้วางสำเนาชุดที่สองไว้ใน /root/.config/hoptodesk แอปจะใช้สำเนานี้ที่หน้าจอเข้าสู่ระบบ ก่อนที่ผู้ใช้จะลงชื่อเข้าใช้

ตัวเลือก B: โฮสต์ไฟล์ไว้ที่ URL แล้วเลือกในแอป

1. อัปโหลด api.json ไปยังเว็บเซิร์ฟเวอร์ใดก็ได้ที่อุปกรณ์ของคุณเข้าถึงได้ แนะนำให้ใช้ HTTPS
2. ใน HopToDesk ให้คลิกไอคอนรูปเฟืองเพื่อเปิดการตั้งค่า
3. ใน Network ให้คลิก Choose Network
4. เลือก Custom Network Settings วาง URL ของไฟล์ของคุณ แล้วยืนยัน
5. HopToDesk จะดาวน์โหลดไฟล์ ตรวจสอบว่ามีรายการ rendezvous ที่ถูกต้องและรายการ turnservers จากนั้นเชื่อมต่อใหม่ผ่านเซิร์ฟเวอร์ของคุณ

หากต้องการกลับไปใช้เครือข่ายสาธารณะ ให้เปิด Choose Network อีกครั้งแล้วเลือก HopToDesk Network (Default)

บน Android และ iOS ให้เปิดการตั้งค่า ปิด Use HopToDesk Network ในส่วนเครือข่าย แล้วป้อน URL ของไฟล์ของคุณ โทรศัพท์ที่จัดการผ่าน EMM สามารถรับ URL เดียวกันได้ผ่านการตั้งค่าที่จัดการ custom_api_url

ตัวเลือก C: ส่งการตั้งค่าจากแดชบอร์ด

หากอุปกรณ์ของคุณเชื่อมโยงกับแดชบอร์ด HopToDesk คุณสามารถตั้งค่าเครือข่ายครั้งเดียวสำหรับทั้งบัญชี ไคลเอนต์แบบกำหนดเองที่สร้างจากแดชบอร์ดจะมีการตั้งค่าเหล่านี้ติดมาด้วย

เซิร์ฟเวอร์ใหม่: ในแดชบอร์ด เปิดการตั้งค่า, Network Settings, Set up a private network เลือก In my AWS account หรือ On my own server เซิร์ฟเวอร์จะรายงานที่อยู่ของตนเมื่อเริ่มทำงาน และอุปกรณ์ที่เชื่อมโยงทุกเครื่องจะได้รับการตั้งค่า ไม่ต้องพิมพ์อะไรเลย

เซิร์ฟเวอร์ที่คุณใช้งานอยู่แล้ว: ป้อนการตั้งค่าด้วยตนเอง

1. เข้าสู่ระบบแดชบอร์ดในฐานะเจ้าของหรือผู้ดูแลระบบ แล้วเปิดการตั้งค่า
2. ใน Network Settings ให้เลือก Custom Network
3. ป้อนโฮสต์ของเซิร์ฟเวอร์สัญญาณ พอร์ต และ WS เป็นโปรโตคอล เพิ่มเซิร์ฟเวอร์ TURN หากคุณใช้รีเลย์ของตัวเอง หรือเว้นว่างไว้เพื่อใช้รีเลย์ของ HopToDesk ต่อไป
4. คลิก Save Network Settings อุปกรณ์ที่เชื่อมโยงทุกเครื่องจะได้รับการตั้งค่าใหม่และนำไปใช้โดยไม่ต้องติดตั้งใหม่

ใช้รีเลย์ TURN ของคุณเอง (ไม่บังคับ)

เซสชันที่เชื่อมต่อโดยตรงไม่ได้จะผ่านรีเลย์ของ HopToDesk เป็นค่าเริ่มต้น หากต้องการให้ข้อมูลทั้งหมดอยู่ในโครงสร้างพื้นฐานของคุณเอง ให้ใช้เซิร์ฟเวอร์ TURN เซิร์ฟเวอร์ TURN มาตรฐานใดก็ใช้ได้ และ coturn เป็นตัวเลือกที่นิยมบน Linux

1. ติดตั้ง coturn บนเซิร์ฟเวอร์รีเลย์

sudo apt install coturn

2. แก้ไข /etc/turnserver.conf และตั้งค่าอย่างน้อยตามด้านล่าง แทนที่ realm ข้อมูลรับรอง และ IP สาธารณะด้วยของคุณเอง

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

3. หาก /etc/default/coturn มีบรรทัด TURNSERVER_ENABLED ให้เอาเครื่องหมายคอมเมนต์ออก จากนั้นเปิดใช้และเริ่มบริการ

sudo systemctl enable --now coturn
sudo systemctl restart coturn

4. เปิดพอร์ตรับฟังสำหรับ TCP และ UDP รวมถึงช่วงพอร์ตรีเลย์ UDP 49152 ถึง 65535 บนไฟร์วอลล์ของรีเลย์
5. ส่งรีเลย์ให้อุปกรณ์ของคุณ: รันตัวติดตั้งอีกครั้งพร้อมค่า TURN ทั้งสี่ หรือแก้ไขบล็อก turnservers ในการตั้งค่าเครือข่าย ใช้ turn-tls เป็นโปรโตคอลหากรีเลย์ของคุณจัดการ TLS

จัดการเซิร์ฟเวอร์บน Linux

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

หากต้องการอัปเดตเซิร์ฟเวอร์ ให้หยุดบริการแล้วรันคำสั่งติดตั้งอีกครั้ง คำสั่งจะดาวน์โหลดไบนารีล่าสุดและเขียนบริการใหม่

หากต้องการลบเซิร์ฟเวอร์พร้อมบริการและรายการ cron:

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

การแก้ไขปัญหา

• ID ค้างอยู่ที่ Generating หรือแอปพยายามเชื่อมต่อเครือข่ายอยู่ตลอด: อุปกรณ์เข้าถึงเซิร์ฟเวอร์สัญญาณไม่ได้ ตรวจสอบว่าบริการทำงานอยู่ พอร์ต 80 เปิดอยู่ และที่อยู่ในการตั้งค่าเครือข่ายถูกต้อง
• อุปกรณ์เชื่อมต่อได้ใน LAN แต่เชื่อมต่อจากภายนอกไม่ได้: เข้าถึงรีเลย์ไม่ได้ หากใช้รีเลย์เริ่มต้น อุปกรณ์ต้องเข้าถึง turn.hoptodesk.com ขาออกที่พอร์ต 443 ได้ หากใช้รีเลย์ของคุณเอง ให้ตรวจสอบกฎไฟร์วอลล์และข้อมูลรับรอง
• แอปไม่สนใจ api.json: ตรวจสอบว่าไฟล์เป็น JSON ที่ถูกต้องโดยไม่มีเครื่องหมายจุลภาคท้ายสุด อยู่ในโฟลเดอร์ที่ถูกต้อง และคุณได้รีสตาร์ต HopToDesk แล้ว บันทึกของแอปจะมีบรรทัด Loaded local api.json เมื่ออ่านไฟล์สำเร็จ
• พอร์ต 82 คือพอร์ตสหพันธ์สำหรับเชื่อมเซิร์ฟเวอร์สัญญาณของคุณหลายเครื่องเข้าด้วยกัน ให้ปิดไว้ไม่ให้เข้าถึงจากอินเทอร์เน็ต
• เซิร์ฟเวอร์สัญญาณไม่เก็บข้อมูลเซสชัน หากมีอะไรดูค้าง ให้รีสตาร์ตบริการ อุปกรณ์จะเชื่อมต่อใหม่เองภายในประมาณหนึ่งนาที