SuperRenders Client App: Cài đặt và Upload

Tổng quan

SuperRenders Client App là công cụ desktop kết hợp upload, nộp job và download thành một workflow trên máy của bạn. Bạn đăng nhập một lần, thả dự án vào app, xem upload với resumable chunking, nộp qua hộp thoại trong app (hoặc qua plugin nộp bên trong 3ds Max hoặc Maya), sau đó để frame stream về thư mục cục bộ khi render farm hoàn thành.

Với job một lần và dự án nhỏ, web dashboard tại superrendersfarm.com xử lý cùng luồng upload-and-submit mà không cần cài đặt gì. Client App là lựa chọn đúng khi bạn nộp job thường xuyên, dự án đạt nhiều gigabyte, hoặc bạn muốn đầu ra đến local disk mà không cần canh một download queue.

---

Khi nào dùng Client App vs web dashboard

Hai cái này không loại trừ nhau — job nộp qua cả hai hướng đều hiển thị trong cả hai view; chúng đọc từ cùng backend.

Chọn Client App khi ít nhất một điều này đúng:

Bạn nộp job nhiều hơn vài lần mỗi tháng.
Kích thước dự án thường xuyên vượt vài gigabyte.
Bạn muốn frame đầu ra đến local disk tự động khi hoàn thành.
Bạn làm việc trong 3ds Max hoặc Maya và muốn nộp một cú nhấp từ bên trong DCC.
Bạn quản lý nhiều job đồng thời và muốn view queue dạng panel.

Chọn web dashboard khi job là một lần, dự án nhỏ, bạn không thể cài phần mềm desktop trên máy trạm, hoặc bạn chỉ cần tải thủ công một vài frame.

---

Cài đặt

Client App được tải từ dashboard sau khi bạn đăng nhập.

Đăng nhập hoặc đăng ký. Truy cập https://superrendersfarm.com/ và đăng nhập.

Mở panel tải về. Từ Client Area, tìm nút DOWNLOAD CLIENT APP trong top panel của render dashboard.

Chọn build phù hợp. Ba build có sẵn: - Windows — build được test nhiều nhất và cập nhật thường xuyên nhất. - macOS — hỗ trợ Intel và Apple Silicon. Nếu Gatekeeper challenge hành động mở, xem ghi chú macOS trong Troubleshooting. - Linux — build giới hạn được xuất bản khi cơ sở khách hàng tăng. Người dùng Linux có thể dùng web dashboard hoặc SFTP.

Chạy installer. .exe chuẩn trên Windows, .dmg trên macOS. Installer Windows đăng ký background service xử lý upload và download khi cửa sổ app chính bị đóng.

Lưu ý về antivirus và SmartScreen: installer được ký, nhưng vì bất kỳ app desktop render farm nào cũng có cơ sở khách hàng tương đối nhỏ, một số công cụ antivirus đánh dấu nó khi chạy lần đầu. Nếu phần mềm antivirus của bạn chặn, hãy thêm exception cho thư mục SuperRenders hoặc tạm thời giảm real-time scanning trong quá trình cài.

Đăng nhập trong app. Khi khởi chạy lần đầu, Client App yêu cầu thông tin đăng nhập superrendersfarm.com. App lưu session token cục bộ; bạn sẽ không cần nhập lại mật khẩu trừ khi đăng xuất.

Nếu đăng nhập thất bại dù thông tin đúng, hai nguyên nhân phổ biến nhất là clock skew (đồng hồ máy trạm lệch đáng kể so với thời gian server) và session token cũ từ lần cài trước.

---

Panel Plugins và submission plugin

Khi Client App đang chạy, panel Plugins quản lý DCC submission plugin đi kèm. Submission plugin là tích hợp một cú nhấp thêm menu SuperRenders bên trong 3ds Max hoặc Maya để bạn có thể nộp scene đang mở mà không cần rời DCC.

Cơ bản về Plugins panel

Theo mặc định, Client App phát hiện DCC đã cài (Windows registry trên Windows; thư mục Applications macOS) và đề nghị cài submission plugin tương ứng tự động. Sau auto-install, bạn có thể cần restart DCC một lần để menu mới đăng ký.

Nếu menu SuperRenders không xuất hiện trong 3ds Max hoặc Maya sau khi restart:

Mở Client App.
Chuyển đến panel Plugins.
Nhấp Scan To Update.

Client App quét lại các DCC đã cài và cài lại plugin khi cần. Trạng thái bên cạnh mỗi DCC sẽ thay đổi thành Up to date khi cài hoàn thành.

Hiện tại submission plugin chỉ dành cho 3ds Max và Maya. Các DCC khác (Cinema 4D, Blender, Houdini, After Effects) dùng hướng web upload hoặc Client App upload — không có tích hợp menu trong DCC cho những phần mềm đó hôm nay.

---

Upload dự án (workflow chuẩn)

Luồng upload của Client App là hướng chuẩn cho dự án vượt quá mức thoải mái qua browser upload.

1. Mở panel SRF Spaces

Nhấp panel SRF SPACES ở top của dashboard trong Client App. SRF Spaces là không gian lưu trữ cloud gắn với tài khoản của bạn — file được upload ở đây hiển thị cho tất cả render worker mà job của bạn sẽ chạy trên.

2. Chọn Add Files / Add Folders, hoặc kéo thả

Bên trong panel SRF Spaces, nhấp UPLOAD. Hai cách:

Add Files / Add Folders. Hộp thoại file-picker chuẩn.
Kéo và thả. Kéo thư mục hoặc chọn file từ file manager của hệ điều hành trực tiếp vào cửa sổ Client App.

Với hầu hết workflow, kéo thả là hướng nhanh hơn vì bạn thường upload một thư mục dự án đóng gói đơn lẻ.

3. Cấu hình "Auto keep local path"

Đây là tùy chọn studio archviz quan tâm nhiều nhất. Bên trong hộp thoại upload có checkbox Auto keep local path.

Khi Auto keep local path được chọn, Client App bảo toàn đường dẫn tuyệt đối của file cục bộ khi upload lên SRF Spaces. Nếu dự án cục bộ nằm tại D:\projects\client-acme\scene-final\ trên Windows, Client App sẽ tạo cùng cấu trúc thư mục bên trong SRF Spaces. Render worker, khi kéo dự án, thấy cùng đường dẫn D:\projects\client-acme\scene-final\ tồn tại trên máy của bạn.

Điều này quan trọng với dự án chứa tham chiếu absolute-path — thư viện người Anima, vật liệu Substance, alembic cache, Corona 4K cache và nhiều cài đặt Forest Pack archviz đều giữ đường dẫn tuyệt đối bên trong. Khi upload bảo toàn các đường dẫn đó, render worker tìm thấy asset mà không cần bạn phải link lại hay làm tương đối.

Khi Auto keep local path không được chọn, Client App upload file vào thư mục upload mặc định bên trong SRF Spaces, và dự án có tham chiếu absolute-path sẽ thất bại Scene Analysis với lỗi "Asset Missing". Để đã chọn trừ khi bạn biết dự án dùng đường dẫn tương đối hoàn toàn.

Với dự án cần đường dẫn tuyệt đối cụ thể không phải đường dẫn cục bộ hiện tại — ví dụ: dự án được copy từ layout ổ đĩa của studio khác — xem phần trong tài liệu Utilities.

4. Xem BACKGROUND TASKS để theo dõi tiến trình

Khi upload bắt đầu, Client App mở chỉ báo BACKGROUND TASKS ở đáy cửa sổ. Bạn có thể đóng hộp thoại upload và upload vẫn tiếp tục.

Resumable upload. Nếu kết nối bị ngắt giữa chừng, Client App tiếp tục từ chunk cuối cùng được chuyển thành công khi kết nối trở lại.
Parallel chunk transfer. File lớn được chia thành chunk và upload song song.

Với dự án trên ~300 GB, Client App vẫn chậm hơn SFTP — SFTP đạt throughput single-connection cao hơn.

5. Sau upload — cổng Scene Analysis

Khi upload xong, dự án đã ở SRF Spaces nhưng chưa phải job đã nộp. Bước tiếp theo là Scene Analysis, xác thực rằng dự án đã upload sẽ render thành công trên farm trước khi bất kỳ credit nào bị tính.

Để bắt đầu analysis thủ công từ panel SRF Spaces:

Mở SRF SPACES.
Nhấp thư mục dự án vừa upload.
Chọn Yes! Analyze it khi được nhắc, hoặc click phải thư mục và chọn Analyze Scene.
Điền tham số analyze (file scene, render engine, frame range hint) và nhấp Analyze scene.

Trạng thái Scene Analysis có thể là:

Checked In Analyze — analysis đã queue.
Analyzing — analysis đang chạy trên worker.
Analyze Complete — analysis thành công; dự án sẵn sàng để nộp.
Analyze Failed — analysis phát hiện vấn đề. Mở error log để xem asset hoặc cài đặt nào cần điều chỉnh.

Để biết thông báo lỗi mà Scene Analysis hiển thị và cách khắc phục, xem .

---

Nộp render job

Khi Scene Analysis hoàn thành thành công, dự án sẵn sàng render.

Tùy chọn A: Nộp từ Client App

Chuyển đến tab Scene Analysis.
Tìm job đã analyze; nhấp Start Render Job. Hộp thoại "Add New Render Job" mở.
Xem lại Analysis Results và chọn Continue để tiến đến Scene Params.
Cấu hình tham số render — frame range, output format, priority (Normal hoặc Express).
Nhấp Start Render Job để xác nhận.

Tùy chọn B: Nộp từ bên trong 3ds Max hoặc Maya (qua submission plugin)

Trong 3ds Max: mở scene, sau đó nhấp menu SuperRenders. Plugin mở. Khi khởi động plugin chạy analysis pass trên scene đang mở; nếu có cảnh báo hoặc lỗi, hãy giải quyết và nhấp re-analyze. Khi scene sẵn sàng, nhấp Submit to SuperRenders.

Trong Maya: mở scene và nhấp menu SuperRenders. Luồng giống hệt 3ds Max — analyze, review, nộp. Plugin Maya đọc active render layer và tôn trọng render setup như đã cấu hình trong scene.

Nếu menu SuperRenders bị thiếu trong DCC, đóng DCC, quay lại Plugins panel của Client App, nhấp Scan To Update, đợi trạng thái đọc Up to date, sau đó mở lại DCC.

Theo dõi tiến trình

Panel Render Jobs trong Client App hiển thị:

ID # và tên scene
Cost — render credit tính cho job này (1 credit = $1)
Status — In Rendering / Paused / Completed / Error với thanh tiến trình
Cột Action — Sync output, Pause, View details, Delete, Download render output

---

Tải đầu ra về

Auto-download (mặc định)

Theo mặc định, Client App tải mỗi frame đầu ra về máy cục bộ ngay khi hoàn thành render trên farm. Đến khi toàn bộ job hoàn thành, tất cả frame đã ở ổ đĩa — không cần bước download riêng.

Vị trí download mặc định được cấu hình trong Settings → Downloads → Default download path. Ghi đè per-job có sẵn trong view chi tiết job.

Manual download

Nếu bạn muốn tải tất cả frame cùng một lúc khi job hoàn thành, chuyển chế độ trong Settings → Downloads sang manual.

Trong chế độ manual, Client App giữ frame trên farm cho đến khi bạn bắt đầu download. Khi job hoàn thành:

Mở panel Render Jobs.
Tìm job đã hoàn thành.
Nhấp Download Output trong cột Action để kéo tất cả frame về cùng một lúc.

Cửa sổ lưu giữ đầu ra

Đầu ra render được lưu trên farm 45 ngày sau khi job hoàn thành, sau đó tự động xóa. Auto-download giảm thiểu cửa sổ lưu giữ vì frame kéo về khi hoàn thành.

---

Cấu hình và cài đặt

Default output folder (Settings → Downloads) — nơi frame auto-download đến.
Run on Windows startup (Settings → System) — giữ background service khả dụng qua reboot.
Bandwidth limits (Settings → Network) — giới hạn upload và download.
Concurrent transfer limit (Settings → Network) — mặc định là 1.
Notification preferences (Settings → Notifications) — sự kiện submit / complete / milestone / error.
Account sign-out (Settings → Account) — đăng xuất từ máy trạm dùng chung.

---

Khắc phục lỗi (đặc thù Client App)

Để biết thông báo lỗi cross-DCC, xem . Danh sách dưới đây là cho vấn đề đặc thù của Client App.

Đăng nhập thất bại dù thông tin đúng. Hai nguyên nhân phổ biến: session token cũ (Settings → Account → Sign Out, thoát app, đăng nhập lại), hoặc clock skew (xác nhận đồng hồ hệ thống trong vòng một phút so với thời gian thực).
Upload trông bị dừng ở 0 byte trong thời gian dài. Kiểm tra chỉ báo mạng của Client App. "Disconnected" nghĩa là internet của bạn bị ngắt — upload sẽ tự resume khi kết nối trở lại. "Connected" nhưng không có tiến trình thường được giải quyết bằng restart Client App.
Auto-download không kéo frame về. Xác nhận download path có thể ghi. Nguyên nhân phổ biến nhất là đường dẫn đã bị xóa hoặc chuyển kể từ khi job nộp. Cập nhật Settings → Downloads → Default path đến vị trí hiện tại, sau đó nhấp Sync output trên job đó để thử lại.
Menu "SuperRenders" bị thiếu trong 3ds Max hoặc Maya. Mở Plugins panel của Client App, nhấp Scan To Update, đợi Up to date, sau đó restart DCC.
Client App dùng quá nhiều CPU trong khi upload. Giảm concurrent transfer limit trong Settings → Network.
Job nộp qua Client App không xuất hiện trong web dashboard. Refresh web dashboard; delay sync 1–2 phút là bình thường. Nếu job vẫn không xuất hiện sau 5 phút, hãy liên hệ support.
Windows service không start sau Windows update. Chạy lại Client App installer với quyền administrator.
Lỗi "App is damaged and can't be opened" trên macOS. Mở System Preferences → Security & Privacy → nhấp Open Anyway bên cạnh mục SuperRenders. Hoặc chạy xattr -d com.apple.quarantine /Applications/SuperRenders.app từ Terminal.
Checkbox Auto keep local path bị greyed out. Xảy ra khi cài mới trước khi Client App đã lập chỉ mục file system cục bộ. Restart Client App; khi khởi chạy lại checkbox sẽ active.
Output download bị paused và không resume. Click phải job trong Render Jobs panel và chọn Sync output. Điều này re-queue download từ farm.

---

Con đường di chuyển: SuperRenders Spaces

Chúng tôi đang phát triển Spaces, công cụ desktop kế nhiệm gộp các khả năng của Client App (upload, download, quản lý job) vào khái niệm project-workspace rộng hơn.

Kế hoạch:

Client App hiện tại tiếp tục được hỗ trợ. Khách hàng hiện có có thể giữ dùng vô thời hạn.
Spaces sẽ ra mắt song song với Client App ban đầu, không phải thay thế.
Hướng dẫn di chuyển chính thức sẽ được xuất bản ở đây khi Spaces đạt general availability.
Không có kế hoạch ngừng hỗ trợ Client App trong năm 2026.

Nếu bạn bắt đầu hôm nay, Client App là hướng được khuyến nghị. Người dùng hiện tại không cần thực hiện hành động nào cho quá trình chuyển đổi Spaces.

---

Tham khảo thêm

— hướng dẫn submission đầy đủ từ góc nhìn tài khoản mới
— cách render credit được tính per-job
— so sánh web, Client App, SFTP và cloud-sync upload
— Simulate Local Path, Render Node Template, Troubleshoot Machine, API auth
— cài submission plugin và thiết lập DCC
— cài Maya submission plugin và chuẩn bị scene
— khắc phục lỗi cross-DCC cho Scene Analysis

---

FAQ

Q: Tôi có phải dùng Client App không, hay có thể làm mọi thứ từ web dashboard? A: Web dashboard hỗ trợ luồng upload-submit-download đầy đủ mà không cần Client App. Client App là lựa chọn đúng cho studio có job định kỳ, kích thước dự án lớn hơn, workflow archviz absolute-path, hoặc yêu cầu auto-download. Cả hai hướng đọc từ cùng backend.

Q: DCC nào được submission plugin trong app hỗ trợ? A: 3ds Max và Maya kể từ build Plugin v1 hiện tại. Cinema 4D, Blender, Houdini và After Effects dùng luồng upload-and-submit của Client App mà không có tích hợp menu DCC.

Q: Client App có hoạt động trên Linux không? A: Build Linux được xuất bản khi cơ sở người dùng đủ lớn. Trong thời gian giữa các build, người dùng Linux thường dùng web dashboard hoặc SFTP.

Q: Nhiều người trong studio có thể dùng chung một đăng nhập Client App không? A: Tính năng multi-user/team hiện không có sẵn — mỗi người dùng đăng nhập bằng thông tin tài khoản riêng. Chia sẻ một đăng nhập không được khuyến nghị vì audit trail trở nên không rõ ràng.

Q: Upload của tôi bị tạm dừng và tôi đóng Client App. Có tự resume khi mở lại không? A: Có. Client App lưu trạng thái upload ra đĩa, vì vậy đóng và mở lại sẽ tiếp tục từ chỗ bỏ. Trên Windows, background service xử lý upload ngay cả khi cửa sổ chính bị đóng.

Q: Tốc độ upload của Client App so với browser upload như thế nào? A: Với file nhỏ (dưới vài GB), tương đương. Với file lớn hơn, Client App thường nhanh hơn vì dùng parallel chunk upload. Với file rất lớn (trên ~50 GB đường dài), SFTP thường nhanh hơn cả hai.

Q: Có thể dùng Client App mà không cần kết nối internet không? A: Không — kết nối internet hoạt động là bắt buộc. Bạn có thể stage upload offline và chúng sẽ bắt đầu transfer khi kết nối trở lại, nhưng nộp job, theo dõi job và download đều cần kết nối.

Q: Frame đầu ra của tôi được tải tự động nhưng tôi không tìm thấy. Chúng đi đâu? A: Đường dẫn download mặc định được hiển thị trong Settings → Downloads → Default path. Nếu không tìm thấy frame ở vị trí mặc định, tìm kiếm file .exr hoặc .png được sửa đổi trong cửa sổ hoàn thành job.

Q: Client App có hỗ trợ xác thực hai yếu tố (2FA) không? A: 2FA hiện không được hỗ trợ trên tài khoản superrendersfarm.com. Hỗ trợ 2FA nằm trong roadmap.

---

SuperRenders Client App: Cài đặt, Upload và Download

SuperRenders Client App: Cài đặt, Upload và Download