Skip to content

Releases

Teleport v1.3.0

Choose a tag to compare

@github-actions github-actions released this 20 Nov 03:57
14dc746

Added

  • Nâng cấp toàn diện Chế độ khách qua Web QR (teleport.net.web_guest, teleport.net.web_guest_assets, teleport.app.web_guest, teleport.cli):
    • Hỗ trợ đóng gói và truyền phát luồng ZIP trực tiếp (GET /api/download-zip và tải thư mục chia sẻ qua GET /api/download/<id>) với bộ nhớ $O(1)$ không tạo tệp tạm trên đĩa.
    • Hỗ trợ chọn hoặc kéo thả nhiều tệp và cả thư mục từ trình duyệt điện thoại lên máy tính, giữ nguyên cấu trúc thư mục con (rel_path) qua sanitize_rel_path và chặn thoát thư mục.
    • Tự động kiểm tra dung lượng trống trước khi ghi đĩa (507 Insufficient Storage).
    • Nâng cấp bảo mật xác thực: so sánh token hằng thời gian (hmac.compare_digest), tạm khóa IP 5 phút (429 Too Many Requests) khi nhập sai token quá 5 lần liên tiếp, và tự cập nhật danh sách chia sẻ qua Server-Sent Events (/api/events).
    • Lệnh teleport guest hỗ trợ truyền cả tệp lẻ lẫn thư mục vào danh sách chia sẻ.
  • Tự động tạo thư mục con cho từng lượt nhận theo định dạng [Tên thiết bị] (YYYY-MM-DD HH-MM) kèm công tắc bật/tắt trong Cài đặt (teleport.app.transfers, teleport.app.settings, teleport.ui.settings, teleport.ui.web_guest_dialog).
  • Đóng gói và phát hành tự động đa nền tảng trên CI (.github/workflows/release.yml):
    • Tích hợp quy trình build Linux AppImage tự động (.github/workflows/build-linux.yml, packaging/linux/build-appimage.sh) sử dụng appimagetool với cờ APPIMAGE_EXTRACT_AND_RUN=1.
    • Tích hợp quy trình build macOS DMG tự động (.github/workflows/build-macos.yml, packaging/macos/build-dmg.sh) đóng gói tệp cài đặt .dmg hoàn chỉnh bằng hdiutil.
    • Mở rộng job publish trong release.yml tự động thu thập và xuất bản trọn vẹn bộ cài Windows (.exe, .zip), Linux (.AppImage) và macOS (.dmg) kèm mã băm SHA-256 chính thức trên GitHub Releases.
  • Giao tiếp liên tiến trình (IPC) giữa CLI và GUI Node Daemon (teleport.app.ipc):
    • Kênh giao tiếp IPC cục bộ bảo mật qua loopback TCP 127.0.0.1, xác thực bằng token ngẫu nhiên 32-byte (ipc.json).
    • Lệnh CLI teleport send, teleport list và teleport unpair tự động phát hiện khi tiến trình giao diện hoặc daemon đang chạy, ủy quyền thực thi trực tiếp qua IPC mà không bị chặn bởi khóa độc quyền node.lock.
    • Hỗ trợ truyền phát tiến độ tệp trực quan từ daemon về terminal theo thời gian thực.
    • Tự động phát hiện và dọn dẹp các tệp ipc.json mồ côi nếu daemon gặp sự cố kết thúc đột ngột.

Changed

  • Tối ưu bộ nhớ kiểm tra toàn vẹn Merkle (teleport.core.merkle): bổ sung lớp MerkleStream tính Merkle root dạng luồng chỉ giữ ngăn xếp $O(\log_2 N)$ đỉnh trung gian (< 1 KiB RAM cho mọi cỡ tệp tới 4 TiB) và chuyển merkle_root() sang tính trực tiếp trên MerkleStream.
  • Đồng bộ hệ thống tài liệu dự án (docs/product/ke_hoach.md, docs/product/mvp.md, docs/product/huong_dan_su_dung.md, docs/technical/protocol.md, docs/technical/architecture.md, README.md) khớp với hiện trạng v1.3.0.

Trước khi tải và chạy

  • Bản phát hành. Hỗ trợ đa nền tảng: Windows 10/11 64-bit (bộ cài teleport-setup-1.3.0-x64.exe, bản zip giao diện và CLI), Linux x86_64 (AppImage chạy ngay), và macOS (tệp .dmg).
  • Bản Windows chưa ký mã: Windows SmartScreen có thể hiện “Windows protected your PC”. Bấm “More info” → “Run anyway”.
  • Dùng bản zip giao diện (teleport-gui-…) thì đọc DOC-TRUOC.txt trong thư mục giải nén trước khi chạy (chỗ giải nén, tường lửa, hồ sơ mạng Private).
  • Kiểm file tải về bằng SHA256SUMS.txt: dùng Get-FileHash (PowerShell) hoặc sha256sum (Linux/macOS) rồi so với dòng cùng tên.
  • Giấy phép: Teleport theo GPL-3.0-or-later; giấy phép các thành phần đi kèm ở THIRD-PARTY-NOTICES.txt, nơi lấy mã nguồn ở SOURCE.txt (cả hai nằm cạnh file exe, trong bản zip lẫn thư mục cài). Mã nguồn thư viện LGPL đóng kèm: zeroconf-0.151.5.tar.gz.

Teleport v1.2.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 01:19
3e03b45

Added

  • Chế độ khách qua Web QR (Web Guest Mode):
    • Chuyển tệp tức thì với điện thoại di động trong cùng mạng nội bộ mà không cần cài đặt ứng dụng.
    • Bộ mã hóa mã QR Model 2 thuần túy (sans-IO) theo chuẩn ISO/IEC 18004 không phụ thuộc thư viện ngoài (teleport.core.qr), hỗ trợ xuất ASCII console và SVG monochrome.
    • Máy chủ HTTP/1.1 nội bộ siêu nhẹ (teleport.net.web_guest, teleport.net.web_guest_assets) streaming 64 KiB, xác thực bằng token một lần và chỉ phục vụ trong dải IP nội bộ / loopback.
    • Giao diện web khách 1 tệp HTML (<50 KB) tự động nhận diện chế độ sáng/tối và hỗ trợ song ngữ (tiếng Việt / tiếng Anh).
    • Lệnh dòng lệnh teleport guest [files...] hiển thị mã QR trực tiếp trên terminal.
    • Hộp thoại PySide6/Qt WebGuestDialog hiển thị mã QR, liên kết URL, nút sao chép nhanh và thanh tiến độ nhận tệp thời gian thực từ điện thoại.
    • Nút kích hoạt nhanh ("Chuyển tệp với điện thoại") trên thanh tiêu đề cửa sổ chính.
  • Gửi đồng thời nhiều máy và chế độ ẩn danh mDNS (v1.1.0):
    • Lệnh teleport send <files...> --to máy1,máy2 gửi tệp song song tới nhiều thiết bị.
    • Hỗ trợ gửi trọn vẹn cấu trúc cây thư mục con và thư mục rỗng.
    • Tùy chọn --stealth và chế độ ẩn danh mDNS không quảng bá dịch vụ ra mạng công cộng.

Trước khi tải và chạy

  • Bản phát hành. Chỉ có bản Windows 10/11 64-bit: bộ cài teleport-setup-1.2.0-x64.exe, bản zip giao diện và bản zip dòng lệnh.
  • Bản này chưa ký mã: Windows SmartScreen có thể hiện “Windows protected your PC”. Bấm “More info” → “Run anyway”.
  • Dùng bản zip giao diện (teleport-gui-…) thì đọc DOC-TRUOC.txt trong thư mục giải nén trước khi chạy (chỗ giải nén, tường lửa, hồ sơ mạng Private).
  • Kiểm file tải về bằng SHA256SUMS.txt: trong PowerShell chạy Get-FileHash .\<tên file> -Algorithm SHA256 rồi so với dòng cùng tên.
  • Giấy phép: Teleport theo GPL-3.0-or-later; giấy phép các thành phần đi kèm ở THIRD-PARTY-NOTICES.txt, nơi lấy mã nguồn ở SOURCE.txt (cả hai nằm cạnh file exe, trong bản zip lẫn thư mục cài). Mã nguồn thư viện LGPL đóng kèm: zeroconf-0.151.5.tar.gz.

ZCL Teleport (Bản mới nhất)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 09 Nov 12:57
a51065a

Bản tự động đóng gói mới nhất từ nhánh main. Cập nhật commit: 38c5112

Teleport v0.1.0-alpha

Teleport v0.1.0-alpha Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 05 Nov 08:51
5f57ee1

Added

  • Bản thử nghiệm đầu tiên có trang GitHub Release (pre-release, chỉ Windows, chưa ký mã): bộ cài teleport-setup-…-x64.exe, bản zip giao diện, bản zip dòng lệnh, SHA256SUMS.txt để kiểm file tải về, và mã nguồn zeroconf đúng bản đóng kèm. THIRD-PARTY-NOTICES.txt có thêm thông báo bản quyền của các thư viện Rust nằm trong cryptography.
  • Trang “Cài đặt” trong cửa sổ (nút ⚙ hoặc Ctrl+,; Esc để quay lại), mọi thay đổi có hiệu lực ngay, không có nút Lưu: tên thiết bị (kèm câu nhắc tên hiện với mọi máy trong mạng), mở và đổi thư mục nhận, ngôn ngữ, khởi động cùng Windows, “Cho máy chưa ghép đôi thấy máy này”, “Xóa toàn bộ lịch sử…”, danh sách thiết bị tin cậy với “Hỏi trước khi nhận” và “Hủy ghép đôi…” cho từng máy, giới hạn tốc độ gửi (MB/s), số ngày giữ phần nhận dở, “Xuất log…” ra file zip, phiên bản và giấy phép. Lưu lỗi thì ô hoặc công tắc vừa đổi trở về giá trị cũ và nói rõ lý do. Máy đang ẩn thì thẻ “Máy này” có huy hiệu “Đang ẩn”. Dùng được bằng bàn phím và trình đọc màn hình.
  • Mục “Giao diện” trong Cài đặt (đứng thứ hai): chế độ màu “Theo hệ điều hành” / “Sáng” / “Tối” (thanh tiêu đề Windows đổi theo), sáu màu nhấn (Bạc hà, Đại dương, Tím, Hồng, Hổ phách, Than chì) cho nút chính, thanh tiến độ và khung file gửi đi, và ô Ngôn ngữ (chuyển từ mục Chung). Đổi là áp ngay, mở lại vẫn giữ; chế độ màu, màu nhấn và ngôn ngữ đã lưu được áp trước khi cửa sổ hiện, nên không nháy màu lúc mở. Dùng được bằng bàn phím: Tab vào lựa chọn đang có, phím mũi tên để đổi.
  • Giao diện bằng tiếng Anh (English): chọn ở Cài đặt → Giao diện → Ngôn ngữ, hoặc tự dùng khi hệ điều hành để tiếng Anh. Mọi chữ của cửa sổ, khay, hộp thoại, tooltip và tên cho trình đọc màn hình đều được dịch, kể cả câu có số đếm (“1 device” / “3 devices”), dung lượng, phần trăm và thời gian còn lại (“2.1 MB”, “42.0%”, “1 min 2 sec”). Đổi ngôn ngữ khi đang chạy thì chữ đổi ngay, thông báo đang hiện cũng được dịch lại. Ô giới hạn tốc độ nhận cả “2,5” lẫn “2.5”. Bản dịch đi kèm bộ cài và gói Python.
  • Hộp “Hủy ghép đôi” có ô “Xóa cả lịch sử truyền file với máy này” (bật sẵn).
  • Khởi động cùng Windows: ghi giá trị Teleport trong khóa Run của người dùng, kèm --background --config-dir; nếu đã tắt Teleport trong danh sách ứng dụng khởi động của Windows, hoặc giá trị đang trỏ tới một bản cài hay thư mục cấu hình khác, thì công tắc hiện tắt kèm câu giải thích, Teleport không tự bật lại. Chỉ có trên Windows; bản chạy từ mã nguồn thiếu pythonw.exe thì ẩn hàng này.
  • Trang “Tìm máy mới” (nút “Tìm máy mới” trên màn chính): radar vòng tròn với “Bạn” ở tâm, mỗi máy trong mạng là một bong bóng không chồng lên nhau và giữ chỗ khi danh sách đổi; máy đã ghép đôi hiện mờ, ưu tiên vòng trong. Bấm máy chưa ghép đôi để ghép đôi, bấm máy đã ghép đôi để mở cuộc trò chuyện với máy đó. Ô “Nhập IP…” ở đầu trang để ghép đôi theo địa chỉ khi máy kia không hiện; Esc lần đầu xóa chữ, lần sau quay lại. Có hơn 8 máy hoặc cửa sổ không đủ chỗ thì tự chuyển sang dạng danh sách và nói lý do; nút “Dạng danh sách” / “Dạng vòng tròn” được nhớ cho lần sau. Vòng sóng khi mở trang tự dừng sau vài giây, dừng khi cửa sổ thu nhỏ và tắt theo cài đặt hiệu ứng của Windows. Dùng được bằng Tab, phím mũi tên và trình đọc màn hình.
  • Trang “Chờ ghép đôi” (nút “Chờ ghép đôi” ở trang Tìm máy mới; Esc, “Quay lại” hay “Đóng” để rời): hiện tên máy, mã máy và mọi địa chỉ IPv4 của máy này (kèm cổng khi khác cổng mặc định), mỗi địa chỉ có nút “Chép” để đọc cho máy kia nhập. Khi máy đang ẩn, trang nhắc nhập IP của máy này ở máy kia, và máy này chỉ nhận yêu cầu ghép đôi trong lúc trang đang mở: thu nhỏ cửa sổ vẫn nhận; rời trang hay đóng xuống khay thì thôi nhận (phiên đã nhận vẫn chạy tiếp); mở lại cửa sổ khi trang vẫn đang hiện thì nhận lại. Có yêu cầu thì hộp so mã hiện đè lên trang, ghép xong trang báo kết quả. Máy không có địa chỉ mạng nào, hay chưa mở được chế độ chờ, thì trang nói rõ và chỉ cách sửa.
  • docs/benchmark.md mục 7: mvp N4, phần gửi lại sau khi mất kết nối hay tắt app nhận, đo bằng teleport send / receive thật trên loopback Windows: đạt ở mọi lần đo. Chưa đo: Linux, card mạng thật và macOS (docs/ke_hoach.md mục 5.4, D5).
  • Cài đặt lưu trong settings.json và đổi được ngay khi Teleport đang chạy, không cần khởi động lại: tên máy, thư mục nhận, giới hạn tốc độ gửi, số ngày giữ phần nhận dở, cùng các tùy chọn của giao diện (ngôn ngữ, chế độ màu sáng/tối, màu nhấn, khởi động cùng máy, dạng xem). Giao diện đổi chúng ở trang Cài đặt. Đổi tên máy thì quảng bá trong mạng cập nhật ngay.
  • “Hỏi trước khi nhận” theo từng thiết bị đã ghép đôi, để chọn “Luôn nhận” cho riêng một máy.
  • Tạm dừng nhận file trong phiên chạy, bằng mục “Tạm dừng nhận” có dấu chọn trong menu khay: file mới gửi tới bị từ chối và máy gửi được báo máy kia đang không nhận file mới (CLI: “chưa bật nhận file”), clipboard gửi tới bị bỏ qua, lượt đang nhận vẫn chạy xong; thẻ máy này có huy hiệu “Đã tạm dừng nhận”; mở lại Teleport là nhận như thường. Máy không có khay hệ thống thì không có mục này.
  • Menu khay đủ bốn mục: “Gửi file…” mở danh sách máy đã ghép đôi (máy ngoại tuyến có ghi chú), chọn một máy thì cửa sổ mở đúng cuộc trò chuyện đó kèm hộp chọn file; chưa ghép đôi máy nào thì có lối tắt “Tìm máy mới…”.
  • Biểu tượng khay có dấu nhỏ khi đang truyền, khi tạm dừng nhận và khi không nhận được file (thư mục nhận không mở được); trỏ chuột vào biểu tượng thấy số lượt đang truyền hoặc trạng thái nhận.
  • Nhớ trạng thái cửa sổ: mở lại Teleport thì cửa sổ chính hiện đúng cỡ, vị trí, màn hình và trạng thái phóng to như lúc rời đi, và chọn sẵn cuộc trò chuyện gần nhất. Màn hình cũ không còn (rút màn hình phụ) hoặc đã đổi tỉ lệ hiển thị thì cửa sổ được đưa về vùng đang thấy, chừa chỗ cho thanh tiêu đề ở mép trên. Chưa thử trên máy thật có nhiều màn hình. Chỉ lưu khi thu xuống khay, khi thoát hay khi Windows tắt máy / đăng xuất, và chỉ khi có gì đổi. Cuộc trò chuyện gần nhất bị quên khi hủy ghép đôi máy đó. Cửa sổ đang phóng to bị thu nhỏ rồi mở lại từ khay vẫn giữ phóng to.
  • Nút “Thử lại” trong hộp báo ghép đôi không thành (máy kia đang bận, không kết nối được tới IP đã nhập, mã không trùng hay hết giờ, phiên dừng trước khi hiện mã, không hiện được mã ghép đôi): bấm là ghép đôi lại đúng máy hay đúng địa chỉ đó. Khi mã đã hiện trên hai máy, nút được chọn sẵn là “Đóng”.
  • Nút “Đổi thư mục nhận” trên lượt nhận bị từ chối vì thiếu chỗ hay vì ổ không chứa được file lớn, và trên lượt nhận dừng vì lỗi ghi đĩa hay vì thư mục nhận không còn.
  • Đổi thư mục nhận khi đang chạy, khi chưa có lượt nhận nào đã được chấp nhận. File đang chờ bạn bấm Nhận vẫn để nguyên hộp hỏi và được kiểm lại chỗ trống trên thư mục mới: không đủ chỗ thì bị từ chối như thường, còn nếu bạn đã bấm Nhận trong lúc kiểm thì file được nhận vào thư mục mới ngay khi kiểm xong. Thư mục đã lưu không mở được (ví dụ USB đã rút) thì Teleport vẫn chạy và gửi được, chỉ tạm không nhận cho tới khi chọn lại thư mục.
  • Xuất log thành một file zip để gửi khi báo lỗi; file không có tên máy, mã máy hay danh sách máy đã ghép đôi, nhưng log có thể chứa địa chỉ IP và đường dẫn có tên người dùng.
  • settings.json tạm thời không đọc được (ví dụ đang bị phần mềm khác khóa) thì lần ghi sau chép bản cũ sang settings.json.bak trước, không làm mất cài đặt.
  • Máy đã ghép đôi đổi tên thì máy này tự cập nhật tên đã lưu ở lần kết nối kế tiếp, không cần ghép đôi lại. Tên chỉ được nhận khi chứng chỉ của kết nối khớp chứng chỉ đã lưu, và có trần số lần ghi cho mỗi máy (tên bị trần chặn được áp khi hết trần); tên quảng bá qua mDNS không bao giờ đổi tên đã lưu (docs/protocol.md mục 5.5). Hệ điều hành của máy đã ghép đôi lấy từ kết nối đã xác thực, chỉ giữ trong bộ nhớ, vẫn hiện khi máy đó ngoại tuyến. Nội bộ: sự kiện DeviceRenamed, TrustStore.rename, DeviceRegistry.set_peer_hello.
  • Máy đã ghép đôi tự kết nối lại khi mạng chặn mDNS: Teleport nhớ địa chỉ gần nhất mà máy này đã kết nối tới máy kia thành công (lưu trong trusted.json), và tự thử lại địa chỉ đó khi khởi động hay khi mất kết nối, kể cả khi máy đang ẩn. Không phải nhập IP mỗi lần nếu địa chỉ của máy kia không đổi. Thử lại thưa dần rồi giữ một nhịp chậm để không làm ồn mạng (docs/protocol.md mục 6.2). Địa chỉ chỉ được học từ kết nối đã xác thực chứng chỉ, không bao giờ từ mDNS hay từ lời máy kia tự khai; địa chỉ Internet công khai không được lưu, nên Teleport không tự gọi ra Internet. Hủy ghép đôi thì địa chỉ bị xóa; ghép đôi lại đúng máy đó thì giữ. Nhập IP sai hoặc IP của máy khác không làm mất địa chỉ đã nhớ. Địa chỉ hỏng trong trusted.json chỉ bị bỏ riêng nó, các máy đã ghép đôi vẫn nạp được; mở thư mục cấu hình bằng bản Teleport cũ hơn thì địa chỉ đã nhớ mất, lần kết nối sau học lại.
  • teleport send --to X chạy được khi mạng chặn mDNS mà không cần --address, nếu máy này đã từng kết nối tới X; CLI không in địa chỉ đã nhớ.
  • Nội bộ, cho giao diện “Kết nối bằng IP…” sau này: Node.connect_address trả mã kết quả (kết nối được, không tới được, nhầm máy…), DeviceView.last_address, ConnectFailed.from_hint.
  • docs/benchmark.md: số đo thực tế của các yêu cầu chất lượng. mvp N1 (thiết bị xuất hiện, biến mất khi thoát app, mất mạng đột ngột, tạm dừng máy, app bị giết) đạt khi đo giữa Windows 11 và máy ảo Ubuntu bridged; chưa đo trên hai máy thật.
  • docs/benchmark.md mục 4.6: mvp N3, phần truyền qua teleport send / receive thật trên loopback (một máy), đạt với file 1, 5 và 10 GiB. Chưa đo: ổ đích chậm, truyền qua card mạng giữa hai máy (docs/ke_hoach.md mục 5.4, D3, D4), và RAM lúc rảnh của app có giao diện; mvp N3 chưa xong.
  • Giấy phép GPL-3.0-or-later (LICENSE), khai báo trong pyproject.toml.
  • Khung dự án Python, CI chạy ruff, mypy và pytest trên Windows, macOS, Linux.
  • teleport.core.framing: mã hóa/giải mã khung message điều khiển [4 byte độ dài][JSON] (sans-IO).
  • teleport.net.stream: đọc/ghi message điều khiển trên kết nối asyncio.
  • teleport.trust.identity: danh tính thiết bị gồm khóa ECDSA P-256, chứng chỉ tự ký và fingerprint SHA-256; PeerCert, `peer_...
Read more