👩‍🏫L1节点运行教程

欢迎使用我们的安装指南，这里将指导您一步步完成K3s的安装以及Titan L1节点的配置和启动。请按照下面的步骤操作，确保您的系统配置符合所有要求。

前置步骤：安装 K3s

1. 安装 K3s：

在您的终端中运行以下命令以安装K3s。此步骤将自动下载并安装K3s，同时禁用不必要的组件：

curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="--disable=traefik" sh -s -

2.配置 kubeconfig：

配置kubectl命令行工具的访问权限：

mkdir ~/.kube
sudo cat /etc/rancher/k3s/k3s.yaml | tee ~/.kube/config >/dev/null

3.验证K3s安装成功：

安装完成后，使用以下命令确认K3s已正确安装并运行：

kubectl get nodes

4.安装 Helm 工具：

Helm是管理Kubernetes应用的工具。通过以下命令安装Helm：

wget https://get.helm.sh/helm-v3.11.0-linux-amd64.tar.gz
tar -zxvf helm-v3.11.0-linux-amd64.tar.gz
install linux-amd64/helm /usr/local/bin/helm

5.安装 Ingress Nginx：

通过Helm安装Ingress Nginx，为应用添加HTTP路由规则：

helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm upgrade --install ingress-nginx ingress-nginx \
  --repo https://kubernetes.github.io/ingress-nginx \
  --namespace ingress-nginx --create-namespace

6.使用挂载盘 /mnt/storage：

• 移除默认的 local-path StorageClass 标记：

kubectl patch storageclass local-path -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

• 创建并设置新的存储类为默认：

创建 storageclass.yaml文件，并填入以下内容：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: local-storage
  annotations:
    storageclass.kubernetes.io/is-default-class: "true"
provisioner: rancher.io/local-path
volumeBindingMode: WaitForFirstConsumer
reclaimPolicy: Delete
parameters:
  path: "/mnt/storage"

应用StorageClass到K3s集群：

kubectl apply -f storageclass.yaml

• 更新 ConfigMap 路径为 /mnt/storage：

kubectl patch configmap local-path-config -n kube-system --type=json -p='[{"op": "replace", "path": "/data/config.json", "value":"{\n  \"nodePathMap\":[\n  {\n    \"node\":\"DEFAULT_PATH_FOR_NON_LISTED_NODES\",\n    \"paths\":[\"/mnt/storage\"]\n  }\n  ]\n}"}]'

Titan L1 节点安装和启动

网络要求：

在开始之前，请确保以下端口在您的网络防火墙或路由器上已开放，以确保节点正常通信：

• 9000 TCP: 用于节点之间的通信。

• 2345 TCP/UDP: 用于节点的广播和数据同步。

• 80 TCP: 用于HTTP通信。

• 443 TCP: 用于HTTPS通信。

*如果节点的网络设置不符合我们的要求，节点将无法正常工作，您也将无法获得任何奖励。*

安装步骤：

1.下载 titan-L1 程序:

首先，打开您的Linux终端，并使用以下命令下载最新版本的 titan-L1 程序：

wget https://github.com/Titannet-dao/titan-node/releases/download/v0.1.21/titan-l1-guardian

2.设置执行权限:

下载完成后，需要给这个程序文件设置适当的执行权限，以确保可以顺利运行。请输入以下命令：

chmod 0755 titan-l1-guardian

3.配置存储环境变量:

Titan程序需要知道存储数据的位置。请根据您的系统环境，选择合适的存储路径，然后设置环境变量。例如，如果您希望使用 /mnt/storage 作为存储路径，可以使用以下命令：

export TITAN_METADATAPATH=/mnt/storage
export TITAN_ASSETSPATHS=/mnt/storage

请确保替换 <存储路径> 为您实际的路径。

4.将程序设置为系统服务：

创建一个服务文件 /etc/systemd/system/titan.service：

sudo nano /etc/systemd/system/titan.service

添加以下内容到文件中：

[Unit]
Description=Titan L1 Guardian Service
After=network.target

[Service]
User=root
ExecStart=/path/to/titan-l1-guardian daemon start --init --url https://cassini-locator.titannet.io:5000/rpc/v0 --code <code_id>
Restart=on-failure

[Install]
WantedBy=multi-user.target

注意： 替换 /path/to/titan-l1-guardian 和 <code_id> 为实际路径和代码ID。

这里需要您提供一个有效的 code_id，如果您已经通过了L1节点的审批， code_id 可以在您的TG/邮箱中查看。

5.启用和启动服务：

在启用服务之前，确保系统识别了新的服务文件：

sudo systemctl daemon-reload
sudo systemctl enable titan.service
sudo systemctl start titan.service

6. 👉申请身份码👈

7.绑定身份码:

将申请到的 身份码 替换 your-hash-here

./titan-l1-guardian bind --hash=your-hash-here https://api-test1.container1.titannet.io/api/v2/device/binding

注意事项：

• 确保您使用的存储路径存在且具备写入权限。

• 运行过程中的所有输出将被重定向到 /var/log/guardian.log，您可以随时查看该日志文件以监控程序状态。

• 如果您在任何步骤中遇到问题，请重新检查您输入的命令是否正确，或联系技术支持获取帮助。

以上就是安装和配置Titan L1节点以及K3s的全部步骤。这样设置后，您的Titan节点将作为系统服务运行，确保在遇到意外时能自动重启。如果有任何疑问或需要帮助，请联系我们的技术支持团队。