---
title: "第一个客户端与服务端"
---

> Documentation Index
> Fetch the complete documentation index at: https://openarkstudio.github.io/arknet/llms.txt
> Use this file to discover all available pages before exploring further.

# 第一个客户端与服务端

下面的完整程序启动本地 TCP 回显服务端与客户端，验证回复后停止两者。

1. **创建应用项目**

   按[安装与配置](/arknet/zh/get-started/installation)安装依赖。在 `main.cpp` 所在目录创建
   `CMakeLists.txt`，并将 `/path/to/arknet` 改为实际源码路径：

   ```cmake
   cmake_minimum_required(VERSION 3.21)
   project(arknet_echo LANGUAGES CXX)
   add_subdirectory(/path/to/arknet arknet-build)
   add_executable(arknet_echo main.cpp)
   target_link_libraries(arknet_echo PRIVATE arknet::arknet)
   ```

   arknet 是 header-only 库；接口目标只传递构建配置和依赖。
2. **添加客户端与服务端**

   将下面的完整程序放入 `main.cpp`：

   ```cpp
   #include <chrono>
   #include <future>
   #include <string>

   #include <arknet/arknet.hpp>
   using namespace std::chrono_literals;

   int main()
   {
       arknet::tcp_server server;
       server.bind_recv([](auto& session, std::string_view data)
       {
           session->async_send(data);
       });
       if (!server.start("127.0.0.1", 0, arknet::use_dgram))
           return 1;

       arknet::tcp_client client;
       client.set_auto_reconnect(false);
       std::promise<std::string> reply;
       client.bind_recv([&](std::string_view data)
       {
           reply.set_value(std::string(data));
       });
       if (!client.start("127.0.0.1", server.get_listen_port(), arknet::use_dgram))
           return 2;
       auto result = reply.get_future();
       if (!client.async_send("hello"))
           return 3;
       const bool ready = result.wait_for(5s) == std::future_status::ready;
       const bool correct = ready && result.get() == "hello";
       client.stop();
       server.stop();
       return correct ? 0 : 4;
   }
   ```
3. **构建并检查回显**

   ```sh
   cmake -S . -B build
   cmake --build build --parallel 3
   ./build/arknet_echo
   ```

   退出码为 `0` 表示客户端收到 `hello`，且两个端点已停止。
   使用 Visual Studio 时，构建命令添加 `--config Release`，运行 `build/Release/arknet_echo.exe`。

> **说明：TCP 消息边界**
>
> 两端都使用 arknet 的 `use_dgram` 消息拆包。TCP 本身是字节流，应按对端
> 线路协议选择[拆包方式](/arknet/zh/features/tcp)。等待发生在所有者线程，不在 IO 回调中。

## 下一步

按业务选择 [TCP](/arknet/zh/features/tcp)、[UDP](/arknet/zh/features/udp)、
[WebSocket](/arknet/zh/features/websocket)、[HTTP 与路由](/arknet/zh/features/http)或
[TLS](/arknet/zh/features/tls)。将对象用于服务前，阅读
[生命周期与发送](/arknet/zh/concepts/sending)；共享 context 前，阅读
[IO 模型](/arknet/zh/concepts/io-models)。

Source: https://openarkstudio.github.io/arknet/zh/get-started/first-application/index.mdx