DeskVNCServer - Panduan

Bermula

1. Tetapkan Kata Laluan

Buka Tetapan (ikon gear, bar alat bawah) dan isikan Kata laluan VNC. Klien VNC standard menggunakan cabaran RFB DES, yang hanya menyokong 8 bait pertama yang serasi ASCII — pilih kata laluan tidak melebihi 8 aksara.

2. Mulakan Pelayan

1. Pada tetingkap utama, klik Mula. Penunjuk status bertukar kepada Berjalan.
2. Empat pendengar bermula serentak: VNC 5900, kawalan QREX 5911, media QREX 4010, dan API fail 8766.
3. Klik Salin Maklumat untuk menyalin satu baris dengan hos, port dan PIN semasa ke papan keratan anda.

3. Sambungkan Klien

Untuk pemapar VNC standard (Perkongsian Skrin macOS, RealVNC, TightVNC, aplikasi VNC mudah alih):

1. Buka pemapar dan masukkan vnc://<your-mac-ip>:5900 sebagai alamat
2. Taip kata laluan VNC yang anda tetapkan dalam langkah 1
3. Kawal Mac anda serta-merta — papan kekunci, tetikus, salin/tampal melalui RFB

Untuk aplikasi QuickRemote:

1. Buka QuickRemote pada telefon atau tablet, pilih Tambah Mac
2. Masukkan PIN pasangan 6 digit yang ditunjukkan oleh DeskVNCServer (atau imbas kod QR jika binaan QuickRemote anda menyokongnya)
3. QuickRemote menyimpan token Bearer yang dikembalikan dan membuka kunci ciri lanjutan — IME, audio, penyegerakan papan keratan dan pemindahan fail

Gambaran Keseluruhan Antara Muka

Baris Status

Butang Tindakan

• Mula — Hidupkan keempat-empat pendengar.
• Henti — Tutup setiap pendengar dan putuskan sambungan sesi aktif.
• Salin Maklumat — Salin ringkasan sambungan ringkas (hos, port VNC, port kawalan, PIN) ke papan keratan untuk perkongsian mudah dengan klien.

Panel Sambungan

Memaparkan hos ikatan, port, ID Pelayan semasa dan PIN pasangan aktif. Teks dikemas kini secara automatik apabila tetapan berubah.

Panel API QuickRemote

Rujukan ringkas untuk protokol yang digunakan oleh pelayan. Menyenaraikan versi RFB yang disokong, bentuk titik akhir QREX dan set arahan IME supaya QuickRemote (atau klien anda sendiri) mengetahui perkara yang tersedia.

Protokol dan Port

Pengesahan

• Klien VNC — Kata laluan RFB DES (8 bait pertama yang serasi ASCII bagi kata laluan yang dikonfigurasi).
• Klien QREX — Pertukaran PIN 6 digit awal pada POST /qr/v1/pair mengembalikan token Bearer. Setiap panggilan HTTP QREX dan bingkai WebSocket seterusnya mesti menyertakan Authorization: Bearer <token>.
• Jika kata laluan VNC kosong, pelayan mengiklankan mod tanpa pengesahan RFB standard. Berguna hanya untuk segmen LAN yang dipercayai.

Rujukan pantas titik hujung QREX

GET  /qr/v1/capabilities    # awam, mengembalikan ciri yang disokong
POST /qr/v1/pair            # awam, tukar PIN dengan token Bearer
GET  /qr/v1/ws              # WebSocket, pengesahan diperlukan
POST /qr/v1/ime/get         # pengesahan diperlukan, tanyakan IME aktif
POST /qr/v1/ime/list        # pengesahan diperlukan, senaraikan IME yang tersedia
POST /qr/v1/ime/set         # pengesahan diperlukan, tukar IME
POST /qr/v1/ime/toggle      # pengesahan diperlukan, hidupkan/matikan IME
POST /qr/v1/ime/commit      # pengesahan diperlukan, serahkan rentetan teks

Tetapan

Contoh Klien

Perkongsian Skrin macOS

1. Finder → Pergi → Sambung ke Pelayan
2. Taip vnc://<your-mac-ip>:5900
3. Masukkan kata laluan VNC

cURL — temui keupayaan

curl http://<your-mac-ip>:5911/qr/v1/capabilities

cURL — pasangkan dan panggil jambatan IME

# 1. Tukar PIN dengan token Bearer
TOKEN=$(curl -s http://<your-mac-ip>:5911/qr/v1/pair \
  -H "Content-Type: application/json" \
  -d '{"pin":"123456"}' | jq -r .token)

# 2. Serahkan teks melalui jambatan IME
curl http://<your-mac-ip>:5911/qr/v1/ime/commit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello from remote"}'

Petua

• Kurangkan kadar bingkai dan dimensi bingkai maksimum apabila anda menggunakan sambungan Wi-Fi yang perlahan atau menghalakan sambungan melalui VPN.
• Pasangkan setiap peranti sekali. Selepas pertukaran PIN awal, token Bearer kekal selepas but semula, jadi QuickRemote menyambung semula secara senyap.
• Gunakan Salin Maklumat sebagai cara pantas untuk menghantar butiran sambungan melalui sembang atau e-mel — ia merangkumi semua yang diperlukan oleh klien.
• Kekalkan Dayakan pengubahsuaian fail dimatikan melainkan anda benar-benar memerlukan muat naik. Mod baca sahaja sudah memadai untuk menyemak imbas tangkapan skrin, nota atau muat turun.
• Lumpuhkan API audio apabila tidak menggunakannya. Codec melahu masih menggunakan sedikit CPU pada laluan pengekodan.

Penyelesaian Masalah

Pelayan tidak akan bermula

• Pelayan VNC lain (cth. Perkongsian Skrin macOS) mungkin sudah menggunakan port 5900. Hentikannya daripada System Settings → General → Sharing, atau tukar port dalam tetapan DeskVNCServer.
• Port 5911 / 4010 / 8766 semuanya mesti bebas. Semak dengan lsof -i :5911 dan yang seumpamanya.

Klien VNC gagal disahkan

• Pastikan kata laluan tidak melebihi 8 bait serasi ASCII. Aksara berbilang bait atau rentetan lebih panjang dipendekkan secara senyap oleh pengesahan RFB DES.
• Jika anda memang mahu tanpa kata laluan, biarkan medan kosong dan sambungkan dengan pemapar yang menyokong VNC tanpa pengesahan.

QuickRemote tidak dapat dipasangkan

• Sahkan bahawa telefon atau tablet berada pada Wi-Fi yang sama dengan Mac.
• Buka panel Connection dan baca semula PIN. PIN boleh dijana semula daripada Settings.
• Semak tetapan tembok api macOS — sambungan masuk pada port QREX mesti dibenarkan.

Kawalan jauh terasa lambat

• Kurangkan kadar bingkai dan dimensi bingkai maksimum dalam Settings.
• Lumpuhkan ciri yang tidak digunakan (audio, papan keratan, IME) untuk mengosongkan CPU.

Fail tidak dipindahkan

• Sahkan Dayakan pemindahan fail dihidupkan. Senarai baca sahaja berfungsi tanpa Dayakan pengubahsuaian fail.
• Jika muat naik gagal, dayakan juga Dayakan pengubahsuaian fail. Jika tidak, API fail hanya bertindak balas kepada permintaan baca.

Privasi

• Semua sesi berjalan secara terus antara klien dan Mac anda. Tiada geganti awan, telemetri atau analitik.
• Kata laluan VNC, token Bearer QREX, PIN pemasangan dan ID Pelayan stabil disimpan dalam tetapan aplikasi setempat sahaja.
• Pengubahsuaian fail dimatikan secara lalai. Klien jauh hanya boleh membaca sehingga anda memberikan akses tulis secara jelas.
• Lumpuhkan mana-mana sambungan (audio, papan keratan, pemindahan fail, IME, input jauh) pada bila-bila masa untuk membatalkan keupayaan tersebut serta-merta.
• Jika anda mahu memastikan pelayan setempat pada Mac anda, tetapkan hos ikatan kepada 127.0.0.1.