From d82aef9512dffec635dfa5c637747422e1b7bf8f Mon Sep 17 00:00:00 2001 From: wehub-resource-sync Date: Mon, 13 Jul 2026 11:03:07 +0000 Subject: [PATCH] docs: make Chinese README the default --- README.md | 143 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 74 insertions(+), 69 deletions(-) diff --git a/README.md b/README.md index 5e019c2..5d1aabe 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,12 @@ + +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/alibaba/nacos) · [上游 README](https://github.com/alibaba/nacos/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 -# Nacos: Dynamic *Na*ming and *Co*nfiguration *S*ervice +# Nacos：动态 *Na*ming 与 *Co*nfiguration *S*ervice [![Gitter](https://badges.gitter.im/alibaba/nacos.svg)](https://gitter.im/alibaba/nacos?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) [![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html) [![CI](https://github.com/alibaba/nacos/actions/workflows/ci.yml/badge.svg?branch=develop)](https://github.com/alibaba/nacos/actions/workflows/ci.yml) @@ -11,145 +16,145 @@ ------- -## What does it do +## 它能做什么 -Nacos (official site: [nacos.io](https://nacos.io)) is an easy-to-use platform designed for dynamic service discovery and configuration and service management. It helps you to build cloud native applications and microservices platform easily. +Nacos（官方网站：[nacos.io](https://nacos.io)) 是一款易于使用的平台，专为动态服务发现、配置与服务管理而设计。它可帮助你轻松构建云原生应用和微服务平台。 -Service is a first-class citizen in Nacos. Nacos supports almost all type of services，for example，[Dubbo/gRPC service](https://nacos.io/docs/latest/ecology/use-nacos-with-dubbo/), [Spring Cloud RESTFul service](https://nacos.io/docs/latest/ecology/use-nacos-with-spring-cloud/) or [Kubernetes service](https://nacos.io/docs/latest/quickstart/quick-start-kubernetes/). +服务（Service）在 Nacos 中是一等公民。Nacos 支持几乎所有类型的服务，例如 [Dubbo/gRPC service](https://nacos.io/docs/latest/ecology/use-nacos-with-dubbo/), [Spring Cloud RESTFul service](https://nacos.io/docs/latest/ecology/use-nacos-with-spring-cloud/) 或 [Kubernetes service](https://nacos.io/docs/latest/quickstart/quick-start-kubernetes/). -Nacos provides four major functions. +Nacos 提供四大核心功能。 -* **Service Discovery and Service Health Check** +* **服务发现与服务健康检查（Service Discovery and Service Health Check）** - Nacos makes it simple for services to register themselves and to discover other services via a DNS or HTTP interface. Nacos also provides real-time health checks of services to prevent sending requests to unhealthy hosts or service instances. + Nacos 让服务能够通过 DNS 或 HTTP 接口轻松完成自身注册并发现其他服务。Nacos 还会对服务进行实时健康检查，避免将请求发送到不健康的主机或服务实例。 -* **Dynamic Configuration Management** +* **动态配置管理（Dynamic Configuration Management）** - Dynamic Configuration Service allows you to manage configurations of all services in a centralized and dynamic manner across all environments. Nacos eliminates the need to redeploy applications and services when configurations are updated, which makes configuration changes more efficient and agile. + 动态配置服务（Dynamic Configuration Service）允许你在所有环境中以集中、动态的方式管理所有服务的配置。当配置更新时，Nacos 无需重新部署应用和服务，使配置变更更高效、更敏捷。 -* **Dynamic DNS Service** +* **动态 DNS 服务（Dynamic DNS Service）** - Nacos supports weighted routing, making it easier for you to implement mid-tier load balancing, flexible routing policies, flow control, and simple DNS resolution services in the production environment within your data center. It helps you to implement DNS-based service discovery easily and prevent applications from coupling to vendor-specific service discovery APIs. + Nacos 支持加权路由，便于你在数据中心的生产环境中实现中间层负载均衡、灵活的路由策略、流量控制以及简单的 DNS 解析服务。它可帮助你轻松实现基于 DNS 的服务发现，并避免应用与厂商特定的服务发现 API 耦合。 -* **Service and MetaData Management** +* **服务与元数据管理（Service and MetaData Management）** - Nacos provides an easy-to-use service dashboard to help you manage your services metadata, configuration, kubernetes DNS, service health and metrics statistics. + Nacos 提供易于使用的服务仪表板（dashboard），帮助你管理服务元数据、配置、Kubernetes DNS、服务健康状态及指标统计。 -## Quick Start -It is super easy to get started with your first project. +## 快速入门 +启动你的第一个项目非常简单。 -### Deploying Nacos on cloud +### 在云端部署 Nacos -You can deploy Nacos on cloud, which is the easiest and most convenient way to start Nacos. +你可以在云端部署 Nacos，这是启动 Nacos 最简单、最便捷的方式。 -Use the following [Nacos deployment guide](https://cn.aliyun.com/product/aliware/mse?spm=nacos-website.topbar.0.0.0) to see more information and deploy a stable and out-of-the-box Nacos server. +使用以下 [Nacos 部署指南](https://cn.aliyun.com/product/aliware/mse?spm=nacos-website.topbar.0.0.0) 了解更多信息，并部署稳定、开箱即用的 Nacos 服务器。 -### Start by the provided startup package +### 使用提供的启动包开始 -#### Step 1: Download the binary package +#### 步骤 1：下载二进制包 -You can download the package from the [latest stable release](https://github.com/alibaba/nacos/releases). +你可以从 [最新稳定版本](https://github.com/alibaba/nacos/releases). 下载安装包。 -Take release `nacos-server-1.0.0.zip` for example: +以 `nacos-server-1.0.0.zip` 版本为例： ```sh unzip nacos-server-1.0.0.zip cd nacos/bin ``` -#### Step 2: Start Server +#### 步骤 2：启动服务器 -On the **Linux/Unix/Mac** platform, run the following command to start server with standalone mode: +在 **Linux/Unix/Mac** 平台上，运行以下命令以单机模式（standalone mode）启动服务器： ```sh sh startup.sh -m standalone ``` -On the **Windows** platform, run the following command to start server with standalone mode. Alternatively, you can also double-click the `startup.cmd` to run NacosServer. +在 **Windows** 平台上，运行以下命令以单机模式（standalone mode）启动服务器。你也可以双击 `startup.cmd` 来运行 NacosServer。 ``` startup.cmd -m standalone ``` -For more details, see [quick-start.](https://nacos.io/docs/latest/quickstart/quick-start/) +更多详情，请参阅 [quick-start.](https://nacos.io/docs/latest/quickstart/quick-start/) -## Quick start for other open-source projects: -* [Quick start with Nacos command and console](https://nacos.io/docs/latest/quickstart/quick-start/) +## 其他开源项目快速入门： +* [使用 Nacos 命令行与控制台快速入门](https://nacos.io/docs/latest/quickstart/quick-start/) -* [Quick start with dubbo](https://nacos.io/docs/latest/ecology/use-nacos-with-dubbo/) +* [与 dubbo 快速入门](https://nacos.io/docs/latest/ecology/use-nacos-with-dubbo/) -* [Quick start with spring cloud](https://nacos.io/docs/latest/ecology/use-nacos-with-spring-cloud/) +* [与 spring cloud 快速入门](https://nacos.io/docs/latest/ecology/use-nacos-with-spring-cloud/) -* [Quick start with kubernetes](https://nacos.io/docs/latest/quickstart/quick-start-kubernetes/) +* [与 kubernetes 快速入门](https://nacos.io/docs/latest/quickstart/quick-start-kubernetes/) -## Documentation +## 文档 -You can view the full documentation from the [Nacos website](https://nacos.io/docs/latest/overview/). +你可以从 [Nacos 官网](https://nacos.io/docs/latest/overview/). 查看完整文档。 -You can also read this online eBook from the [NACOS ARCHITECTURE & PRINCIPLES](https://nacos.io/docs/ebook/kbyo6n/). +你也可以在线阅读 [NACOS ARCHITECTURE & PRINCIPLES](https://nacos.io/docs/ebook/kbyo6n/). 电子书。 -All the latest and long-term notice can also be found here from [GitHub notice issue](https://github.com/alibaba/nacos/labels/notice). +所有最新及长期通知也可在 [GitHub notice issue](https://github.com/alibaba/nacos/labels/notice). 中找到。 -## Contributing +## 参与贡献 -Contributors are welcomed to join Nacos project. Please check [CONTRIBUTING](./CONTRIBUTING.md) about how to contribute to this project. +欢迎贡献者加入 Nacos 项目。请查看 [CONTRIBUTING](./CONTRIBUTING.md) 了解如何为本项目做出贡献。 -### How can I contribute? +### 我该如何贡献？ -* Take a look at issues with tags marked [`good first issue`](https://github.com/alibaba/nacos/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) or [`contribution welcome`](https://github.com/alibaba/nacos/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22). -* Answer questions on [issues](https://github.com/alibaba/nacos/issues). -* Fix bugs reported on [issues](https://github.com/alibaba/nacos/issues), and send us a pull request. -* Review the existing [pull request](https://github.com/alibaba/nacos/pulls). -* Improve the [website](https://github.com/nacos-group/nacos-group.github.io), typically we need - * blog post - * translation on documentation - * use cases around the integration of Nacos in enterprise systems. +* 查看带有 [`good first issue`](https://github.com/alibaba/nacos/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) 或 [`contribution welcome`](https://github.com/alibaba/nacos/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22). 标签的 issue +* 在 [issues](https://github.com/alibaba/nacos/issues). 上回答问题 +* 修复 [issues](https://github.com/alibaba/nacos/issues), 中报告的 bug 并向我们提交 pull request。 +* 审阅现有的 [pull request](https://github.com/alibaba/nacos/pulls). +* 改进 [website](https://github.com/nacos-group/nacos-group.github.io), 我们通常需要 + * 博客文章 + * 文档翻译 + * 企业系统中集成 Nacos 的用例 -## Other Related Project Repositories +## 其他相关项目仓库 -* [nacos-spring-project](https://github.com/nacos-group/nacos-spring-project) provides the integration functionality for Spring. -* [nacos-group](https://github.com/nacos-group) is the repository that hosts the eco tools for Nacos, such as SDK, synchronization tool, etc. -* [spring-cloud-alibaba](https://github.com/spring-cloud-incubator/spring-cloud-alibaba) provides the one-stop solution for application development over Alibaba middleware which includes Nacos. +* [nacos-spring-project](https://github.com/nacos-group/nacos-spring-project) 提供 Spring 集成能力。 +* [nacos-group](https://github.com/nacos-group) 是托管 Nacos 生态工具的仓库，例如 SDK、同步工具等。 +* [spring-cloud-alibaba](https://github.com/spring-cloud-incubator/spring-cloud-alibaba) 提供基于阿里巴巴中间件（含 Nacos）的一站式应用开发方案。 -## Contact +## 联系方式 -* [Gitter](https://gitter.im/alibaba/nacos): Nacos's IM tool for community messaging, collaboration and discovery. -* [Twitter](https://twitter.com/nacos2): Follow along for latest nacos news on Twitter. -* [Weibo](https://weibo.com/u/6574374908): Follow along for latest nacos news on Weibo (Twitter of China version). -* [Nacos Segmentfault](https://segmentfault.com/t/nacos): Get latest notice and prompt help from Segmentfault. -* Email Group: - * users-nacos@googlegroups.com: Nacos usage general discussion. - * dev-nacos@googlegroups.com: Nacos developer discussion (APIs, feature design, etc). - * commits-nacos@googlegroups.com: Commits notice, very high frequency. -* Join us from DingDing(Group 1: 21708933(full), Group 2: 30438813(full), Group 3: 31222241(full), Group 4: 12810027056). +* [Gitter](https://gitter.im/alibaba/nacos): Nacos 的 IM 工具，用于社区消息交流、协作与发现。 +* [Twitter](https://twitter.com/nacos2): 在 Twitter 上关注 Nacos 最新动态。 +* [Weibo](https://weibo.com/u/6574374908): 在微博上关注 Nacos 最新动态（中国版 Twitter）。 +* [Nacos Segmentfault](https://segmentfault.com/t/nacos): 从 Segmentfault 获取最新通知与及时帮助。 +* 邮件组： + * users-nacos@googlegroups.com：Nacos 使用相关的一般讨论。 + * dev-nacos@googlegroups.com：Nacos 开发者讨论（API、功能设计等）。 + * commits-nacos@googlegroups.com：提交通知，频率非常高。 +* 通过钉钉加入我们（群 1：21708933（已满），群 2：30438813（已满），群 3：31222241（已满），群 4：12810027056）。 -### DingDing Group QR Code +### 钉钉群二维码 ![](https://cdn.nlark.com/yuque/0/2025/png/1577777/1750054497446-f834cba6-fa83-4421-b202-a0dc1d5cc28b.png) -### DingDing MCP Group QR Code +### 钉钉 MCP 群二维码 ![](https://cdn.nlark.com/yuque/0/2025/png/1577777/1750054500395-e271cbe4-2dd8-4723-8cd0-bd8a731b812a.png) -### WeChat Group QR Code +### 微信群二维码 ![](https://cdn.nlark.com/yuque/0/2025/png/1577777/1750054421702-a7d1421a-ab8e-42da-bc59-01b5d287b290.png) -## Enterprise Service -If you need Nacos enterprise service support, or purchase cloud product services, you can join the discussion by scanning the following DingTalk group. It can also be directly activated and used through the microservice engine (MSE) provided by Alibaba Cloud. +## 企业服务 +如需 Nacos 企业服务支持，或购买云产品服务，可扫描下方钉钉群加入讨论。也可通过阿里云提供的微服务引擎（MSE）直接开通并使用。 https://cn.aliyun.com/product/aliware/mse?spm=nacos-website.topbar.0.0.0 -## Download +## 下载 - [Nacos Official Website](https://nacos.io/download/nacos-server) - [GitHub Release](https://github.com/alibaba/nacos/releases) - -## Who is using -These are only part of the companies using Nacos, for reference only. If you are using Nacos, please [add your company here](https://github.com/alibaba/nacos/issues/273) to tell us your scenario to make Nacos better. +## 谁在使用 + +以下仅是部分使用 Nacos 的公司，仅供参考。如果你也在使用 Nacos，请[在此添加你的公司](https://github.com/alibaba/nacos/issues/273)，向我们介绍你的使用场景，帮助我们改进 Nacos。