---
title: "Cài đặt Mpcium"
description: "Tìm hiểu cách cài đặt và thiết lập Mpcium trong môi trường của bạn."
url: https://docs.fystack.io/vi/mpcium/installation
last_updated: 2026-11-13
---

> ## Documentation index
> Fetch the complete documentation index at: https://docs.fystack.io/llms.txt
> Use it to discover all available pages before exploring further.

# Cài đặt Mpcium

Hướng dẫn này đưa bạn qua quy trình cài đặt và thiết lập các node MPCIUM trong môi trường của bạn.

## Yêu cầu trước

Trước khi bắt đầu, hãy đảm bảo bạn đã có:

- Đã cài đặt **Go** 1.23+: [Cài đặt Go tại đây](https://go.dev/doc/install)
- Server **NATS** đang chạy
- Server **Consul** đang chạy

---

## Clone và cài đặt Mpcium

### Clone repository

```bash
git clone https://github.com/fystack/mpcium.git
cd mpcium
```

### Build dự án

Với Make:

```bash
make
```

Hoặc với Go:

```bash
go install ./cmd/mpcium
go install ./cmd/mpcium-cli
```

### Các lệnh có sẵn

- `mpcium`: Khởi động một node MPCium
- `mpcium-cli`: Tiện ích CLI để cấu hình peer, identity và initiator

---

## Chạy NATS và Consul (chỉ dành cho phát triển)

> ⚠️ Thiết lập này không an toàn và chỉ nên dùng cho mục đích phát triển. Với môi trường production, hãy dùng môi trường cụm an toàn có chứng chỉ TLS.

### Cấu hình Docker Compose

Tạo file `docker-compose.yaml`:

```yaml
version: "3"

services:
  nats-server:
    image: nats:latest
    container_name: nats-server
    command: -js --http_port 8222
    ports:
      - "4222:4222"
      - "8222:8222"
      - "6222:6222"
    tty: true
    restart: always

  consul:
    image: consul:1.15.4
    container_name: consul
    ports:
      - "8500:8500"
      - "8601:8600/udp"
    command: "agent -server -ui -node=server-1 -bootstrap-expect=1 -client=0.0.0.0"
    restart: always
```

### Khởi động các dịch vụ

```bash
docker compose up -d
```

---

## Tạo cấu hình peer

```bash
mpcium-cli generate-peers -n 3
```

Kết quả ví dụ:

```json
{
  "node0": "12345678-1234-1234-1234-123456789abc",
  "node1": "23456789-2345-2345-2345-23456789abcd",
  "node2": "34567890-3456-3456-3456-3456789abcde"
}
```

---

## Cấu hình cụm

### 1. Tạo và cập nhật `config.yaml`

```bash
cp config.yaml.template config.yaml
```

Chỉnh sửa `config.yaml`:

```yaml
nats:
  url: nats://127.0.0.1:4222
consul:
  address: localhost:8500

mpc_threshold: 2
environment: development
badger_password: "your_badger_password"
event_initiator_pubkey: "your_event_initiator_pubkey"
```

### Tạo mật khẩu mạnh (khuyến nghị)

```bash
< /dev/urandom tr -dc 'A-Za-z0-9!@#$^&*()-_=+[]{}|;:,.<>?/~' | head -c 16; echo
```

Ví dụ:

```yaml
badger_password: "F))ysJp?E]ol&I;^"
```

### 2. Đăng ký peer với Consul

```bash
mpcium-cli register-peers
```

---

## Thiết lập Event Initiator

### Tạo initiator

```bash
mpcium-cli generate-initiator
```

> 💡 Hãy dùng `--encrypt` trong môi trường production.

### Thêm khóa công khai vào `config.yaml`

Từ `event_initiator.identity.json`:

```json
{
  "public_key": "09be5d070816aadaa1b6638cad33e819a8aed7101626f6bf1e0b427412c3408a"
}
```

Cập nhật `config.yaml`:

```yaml
event_initiator_pubkey: "09be5d070816aadaa1b6638cad33e819a8aed7101626f6bf1e0b427412c3408a"
```

---

## Cấu hình identity cho các node

### 1. Tạo thư mục cho các node

```bash
mkdir node{0..2}
for dir in node{0..2}; do cp config.yaml peers.json "$dir/"; done
```

### 2. Tạo identity cho từng node

Ví dụ cho `node0`:

```bash
cd node0
mpcium-cli generate-identity --node node0
```

> 💡 Với môi trường production, hãy dùng mã hóa:
>
> ```bash
> mpcium-cli generate-identity --node node0 --encrypt
> ```

### Tạo mật khẩu mạnh để mã hóa

```bash
< /dev/urandom tr -dc 'A-Za-z0-9!@#$^&*()-_=+[]{}|;:,.<>?/~' | head -c 16; echo
```

### 3. Phân phối file identity tới tất cả các node

```bash
cp identity/node0_identity.json ../node1/identity/node0_identity.json
cp identity/node0_identity.json ../node2/identity/node0_identity.json
```

Lặp lại thao tác này cho `node1` và `node2`.

### Ví dụ cấu trúc thư mục

```
├── node0
│   ├── config.yaml
│   ├── identity
│   │   ├── node0_identity.json
│   │   ├── node0_private.key
│   │   ├── node1_identity.json
│   │   └── node2_identity.json
│   └── peers.json
├── node1
│   ├── config.yaml
│   ├── identity
│   │   ├── node0_identity.json
│   │   ├── node1_identity.json
│   │   ├── node1_private.key
│   │   └── node2_identity.json
│   └── peers.json
├── node2
│   ├── config.yaml
│   ├── identity
│   │   ├── node0_identity.json
│   │   ├── node1_identity.json
│   │   ├── node2_identity.json
│   │   └── node2_private.key
│   └── peers.json
```

---

## Khởi động các node Mpcium

Khởi động từng node:

```bash
cd node0
mpcium start -n node0
```

```bash
cd node1
mpcium start -n node1
```

```bash
cd node2
mpcium start -n node2
```

> 💡 Trong môi trường production, hãy tránh hardcode mật khẩu:
>
> ```bash
> mpcium start -n node0 --prompt-credentials
> ```

---

_Image: Tất cả các node đã sẵn sàng_

---

## Triển khai production (bảo mật cao)

1. Sử dụng các cụm **NATS** và **Consul** đạt chuẩn production.
2. Bật **chứng chỉ TLS** trên mọi endpoint.
3. Mã hóa tất cả các khóa:
   ```bash
   mpcium-cli generate-initiator --encrypt
   mpcium-cli generate-identity --node node0 --encrypt
   ```
4. Dùng `--prompt-credentials` để nhập mật khẩu Badger một cách an toàn (tránh hardcode trong `config.yaml`).

---

## Phụ lục

### Giải mã khóa riêng tư của initiator bằng age

```
age --decrypt -o event_initiator.key event_initiator.key.age
```