# Xử lý sự cố cộng tác trực tiếp

Đọc trạng thái đồng bộ, kiểm tra kết nối đến một máy chủ cộng tác, và xử lý các thay đổi đang chờ, bình luận chưa gửi, vấn đề đăng nhập và mạng bị chặn.

Bắt đầu với hai bước kiểm tra: trạng thái đồng bộ của dự án, và **Test connection** cho máy chủ. Cả hai cùng cho bạn biết vấn đề nằm ở máy tính, mạng hay máy chủ của bạn.

## Đọc trạng thái đồng bộ

Di chuột qua biểu tượng trạng thái ở trên cùng khung **Live collaboration**, hoặc chọn nó. Chi tiết hiển thị trạng thái bằng lời, máy chủ mà dự án được chia sẻ trên đó cùng địa chỉ của nó, vai trò của bạn và có bao nhiêu thay đổi đang chờ. [Trạng thái đồng bộ](/docs/collaboration/working-together/#the-sync-status) liệt kê ý nghĩa của từng trạng thái.

## Kiểm tra kết nối

Mở **Settings → Collaboration** và chọn **Test connection** trên thẻ máy chủ. Oleafly chạy các kiểm tra này từ máy tính của bạn và nêu tên vấn đề đầu tiên nó tìm thấy:

| Kiểm tra | Nội dung kiểm tra |
| --- | --- |
| **Address** | Máy chủ trả lời tại địa chỉ này. |
| **Secure connection** | Kết nối được mã hóa và chứng chỉ hợp lệ. |
| **Version** | Phiên bản Oleafly này và máy chủ hoạt động cùng nhau. Nếu không, nó cho biết bên nào cần cập nhật. |
| **Live connection** | Các chỉnh sửa trực tiếp đi qua được. Một ghi chú ở đây nghĩa là chúng đi một đường chậm hơn, nhưng vẫn hoạt động. |
| **Sign-in options** | Máy chủ có ít nhất một cách đăng nhập. |
| **Email** | Máy chủ có thể gửi email hay không. Không có nó, mọi người được thêm mà không nhận email. |
| **Clock** | Đồng hồ trên máy tính của bạn khớp với đồng hồ của máy chủ. |

## Các thay đổi đang chờ

Nếu trạng thái giữ ở **Offline. Changes waiting:** kèm một con số, máy chủ chưa nhận được những thay đổi đó. Chúng vẫn an toàn trên máy tính của bạn, kể cả khi bạn thoát Oleafly.

1. Kiểm tra rằng bạn đang trực tuyến, rồi chạy **Test connection**.
2. Nếu địa chỉ không trả lời, máy chủ có thể đang ngừng hoạt động. Hãy chờ, hoặc hỏi quản trị viên của nó.
3. Đừng đăng xuất để khắc phục. Nếu bạn thử, Oleafly hỏi về các thay đổi chưa gửi. Chọn **Stay signed in**, và chúng sẽ được gửi đi một khi kết nối trở lại.

Bạn không cần làm gì thêm. Các thay đổi tự gửi đi.

## Bình luận không được gửi

Thông báo “Comments are turned off for this project, so the comments you wrote weren't sent” nghĩa là chủ sở hữu hoặc quản trị viên máy chủ đã tắt bình luận trước khi các bình luận của bạn đến được máy chủ. Các thay đổi khác của bạn vẫn được gửi.

Chọn **Show what you wrote**, rồi **Copy text** để giữ lại văn bản. Hãy nhờ chủ sở hữu bật lại bình luận nếu bạn cần. [Tắt bình luận](/docs/collaboration/comments/#turn-comments-off) có chi tiết.

## Một tệp chưa được chia sẻ

- **Larger than this server allows**: tệp chỉ nằm lại trên máy tính của bạn. Hãy làm nó nhỏ hơn và lưu lại.
- **Couldn't be shared**: việc tải lên thất bại. Chọn **Retry**.
- **Waiting to be shared**: việc tải lên chưa diễn ra, thường là vì bạn đang ngoại tuyến. Nó tự gửi đi.

## Các vấn đề đăng nhập

| Thông báo hoặc triệu chứng | Việc cần làm |
| --- | --- |
| “You're not on this server's list yet.” | Nhờ quản trị viên máy chủ thêm bạn. Nếu bạn được mời với tư cách khách, hãy đăng nhập bằng địa chỉ mà lời mời đã gửi đến. |
| Trình duyệt không bao giờ quay lại Oleafly | Dùng **Sign in with a code**. Đọc [Dùng mã](/docs/collaboration/get-started/#with-a-code). |
| “Sign-in took too long.” | Bắt đầu lại. Hoàn tất việc đăng nhập trong cửa sổ trình duyệt đã mở ra. |
| Một liên kết email không hoạt động | Một liên kết chỉ dùng được một lần, trong 15 phút, trên máy tính đã yêu cầu nó. Hãy yêu cầu liên kết mới. Sau vài lần thử, máy chủ yêu cầu bạn chờ 15 phút. |
| Một mã đăng nhập không hoạt động | Mã chỉ dùng được một lần và ngừng hoạt động sau 10 phút. Hãy lấy mã mới trong Oleafly. |
| “Someone else already signed in to this server from this computer account.” | Mỗi người cần tài khoản người dùng riêng của mình trên máy tính. Hãy đăng nhập vào tài khoản người dùng của chính bạn trước. |
| “This address doesn't use a secure connection.” | Máy chủ cộng tác cần địa chỉ https. Hãy kiểm tra địa chỉ với quản trị viên. |
| “This server needs a newer version of Oleafly.” | [Cập nhật Oleafly](/docs/updates/), rồi thử lại. |
| “This server needs an update before it works with this version of Oleafly.” | Nhờ quản trị viên máy chủ cập nhật nó. |
| “This address now belongs to a different server.” | Oleafly không gửi gì đến máy chủ mới. Nếu bạn tin tưởng nó, hãy xóa mục cũ và thêm lại máy chủ. |
| “This server is already in your list under another address.” | Máy chủ đã chuyển nơi. Hãy xóa mục cũ trước, rồi thêm lại nó. |
| “The server is busy.” | Chờ một phút rồi thử lại. |
| Đồng hồ của bạn và của máy chủ lệch nhau nhiều | Đặt ngày và giờ trên máy tính của bạn cho đúng. |
| Lỗi chứng chỉ | Tổ chức của bạn có thể tự ký chứng chỉ của mình. Máy tính của bạn phải tin tưởng tổ chức chứng chỉ đó. Hãy hỏi bộ phận CNTT của bạn. |

## Mạng, proxy và tường lửa

Nếu **Live connection** nói “Something between you and the server blocks live edits”, một tường lửa hoặc proxy trên mạng của bạn đang cản trở. Hãy cho bộ phận CNTT hoặc quản trị viên máy chủ của bạn xem thông báo đó.

Nếu nó nói các chỉnh sửa trực tiếp đi một đường chậm hơn, mạng của bạn chặn kết nối thông thường. Không cần khắc phục gì: mọi chỉnh sửa vẫn đến nơi, chỉ chậm hơn một chút. Đọc [Các mạng chặn kết nối trực tiếp](/docs/collaboration/offline/#networks-that-block-live-connections).

Quản trị viên máy chủ có thể tìm thấy những gì một proxy đặt trước máy chủ cần trong [Lưu trữ, sao lưu và giới hạn](/docs/collaboration/server-operations/#behind-a-reverse-proxy).

## Khi nào nên liên hệ quản trị viên máy chủ

Hãy hỏi người vận hành máy chủ của bạn khi:

- bạn không đăng nhập được, hoặc Oleafly nói rằng bạn không có trong danh sách của máy chủ
- **Test connection** thất bại ở **Address**, **Secure connection** hoặc **Sign-in options**
- Oleafly nói máy chủ cần cập nhật
- tài khoản của bạn bị đình chỉ hoặc quyền truy cập kết thúc và bạn cho rằng đó là nhầm lẫn
- các tệp vượt quá giới hạn kích thước cần được chia sẻ, một dự án cần nhiều người hơn mức máy chủ cho phép, hoặc tài khoản của bạn cần nhiều dung lượng hay nhiều dự án dùng chung hơn mức máy chủ cấp cho mỗi tài khoản
- bạn cần bật khách, chia sẻ bằng liên kết, bình luận hoặc nhật ký truy cập dự án

Với các vấn đề của chính ứng dụng, hãy làm theo [Báo cáo một vấn đề](/docs/faq/#report-a-problem).
