Chuyển tới nội dung chính

Trò chuyện SimpleX`SimpleX Chat là một nền tảng nhắn tin riêng tư, phi tập trung, nơi người dùng sở hữu các liên hệ và nhóm của họ. Không giống như các nền tảng khác, SimpleX không chỉ định ID người dùng cố định — mọi liên hệ đều được xác định bằng ID nội bộ mờ đục được tạo tại thời điểm kết nối, điều này khiến nó trở thành một trong những ứng dụng nhắn tin riêng tư nhất hiện có.

Điều kiện tiên quyết​

  • trò chuyện đơn giản CLI được cài đặt và chạy dưới dạng daemon
  • Gói Python websockets ( `pip install websockets

)

Cài đặt trò chuyện đơn giản​

Tải xuống bản phát hành mới nhất từ trang simplex-chat GitHub releases:


# Linux / macOS binary
curl -L https://GitHub.com/simplex-chat/simplex-chat/releases/latest/download/simplex-chat-ubuntu-22_04-x86-64 -o simplex-chat
chmod +x simplex-chat

`
``Dự án Trò chuyện SimpleX không xuất bản hình ảnh Docker dựng sẵn cho ứng dụng trò chuyện; để chạy nó trong Docker, hãy xây dựng từ nguồn từ [simplex-chat repository](https://GitHub.com/simplex-chat/simplex-chat).

## Khởi động daemon

``` bash
simplex-chat -p 5225

`
``Daemon lắng nghe trên WebSocket tại 
`ws://127.0.0.1:5225
` theo mặc định.

## Định cấu hình Hermes

### Thông qua trình hướng dẫn thiết lập

`bash
Hermes setup gateway

`
``Chọn **Trò chuyện SimpleX** và làm theo lời nhắc.

### Thông qua biến môi trường

Thêm những thứ này vào 

~/.Hermes/.env

:

`
SIMPLEX_WS_URL=ws://127.0.0.1:5225
SIMPLEX_ALLOWED_USERS=<contact-id-1>,<contact-id-2>
SIMPLEX_HOME_CHANNEL=<contact-id>

`

| Biến | Bắt buộc | Mô tả |
|---|---|---|
| 
`SIMPLEX_WS_URL
` | Có | URL WebSocket của trình nền trò chuyện đơn giản |
| 
`SIMPLEX_ALLOWED_USERS
` | Được đề xuất | ID liên hệ được phân tách bằng dấu phẩy được phép sử dụng tác nhân |
| 
`SIMPLEX_ALLOW_ALL_USERS
` | Tùy chọn | Đặt 
`true
` cho phép mọi liên hệ (sử dụng cẩn thận) |
| 
`SIMPLEX_HOME_CHANNEL
` | Tùy chọn | ID liên hệ mặc định để phân phối công việc định kỳ |
| 
`SIMPLEX_HOME_CHANNEL_NAME
` | Tùy chọn | Nhãn con người cho kênh chủ đề |

## Tìm ID liên hệ của bạn

Sau khi khởi động daemon, hãy mở cuộc trò chuyện với người liên hệ với đại lý của bạn. ID liên hệ sẽ xuất hiện trong nhật ký phiên hoặc thông qua 
`Hermes send_message action=list

.

## Ủy quyền

Theo mặc định **tất cả địa chỉ liên hệ đều bị từ chối**. Bạn phải:
1. Đặt 
`SIMPLEX_ALLOWED_USERS
` thành danh sách ID liên hệ được phân tách bằng dấu phẩy hoặc

2. Sử dụng **ghép nối DM** — gửi bất kỳ tin nhắn nào tới bot và bot sẽ trả lời kèm theo mã ghép nối. Nhập mã đó qua 
`Hermes gateway pair

.

## Sử dụng SimpleX với cron jobs

``` python
cronjob(
    action="create",
    schedule="every 1h",
    deliver="simplex",          # uses SIMPLEX_HOME_CHANNEL
    prompt="Check for alerts and summarise."
)

`
``Hoặc nhắm mục tiêu một liên hệ cụ thể:

`Python
send_message(target="simplex:<contact-id>", message="Done!")

`

## Ghi chú về quyền riêng tư
- SimpleX không bao giờ tiết lộ số điện thoại hoặc địa chỉ email — các liên hệ sử dụng ID mờ

- Kết nối giữa Hermes và daemon là WebSocket cục bộ (
`ws://127.0.0.1:5225

) — không có dữ liệu nào rời khỏi máy của bạn
- Tin nhắn được mã hóa hai đầu bởi giao thức SimpleX trước khi đến daemon

## Khắc phục sự cố`**"Không thể truy cập daemon"** — Đảm bảo 
`simplex-chat -p 5225
` đang chạy và cổng khớp với 
`SIMPLEX_WS_URL

.

**"websockets chưa được cài đặt"** — Chạy 
`pip install websockets

.

**Không nhận được tin nhắn** — Kiểm tra xem ID của liên hệ có nằm trong 
`SIMPLEX_ALLOWED_USERS
` hay phê duyệt chúng thông qua ghép nối DM.