Skip to content

quick-start.mdx

Latest commit

 

History

History
146 lines (98 loc) · 5.56 KB

quick-start.mdx

File metadata and controls

146 lines (98 loc) · 5.56 KB
title Nacos Quick Start
keywords
Nacos
Quick Start
description This Quick Start Guide helps you quickly download, install, and use Nacos on your computer.
sidebar
order
1

import { Tabs, TabItem } from '@astrojs/starlight/components';

Nacos 快速开始

这个快速开始手册是帮忙您快速在您的电脑上，下载、安装并使用 Nacos。

:::note

  • 快速开始旨在帮助您快速上手安装、部署及入门使用Nacos，本快速开始所生产出的Nacos服务为单机模式及未开启客户端访问鉴权，建议仅在测试中使用，若在实际生产环境中部署，请部署集群模式并开启鉴权，以避免存在稳定性和安全性的风险。
  • Nacos定义为一个IDC内部应用组件，并非面向公网环境的产品，建议在内部隔离网络环境中部署，强烈不建议部署在公共网络环境。 :::

0. 版本选择

您可以通过Nacos的版本下载页面、release notes 及 发布声明中找到每个版本支持的功能的介绍，生产环境当前推荐的稳定版本为3.0.3.

1. 预备环境准备

Nacos 依赖 Java 环境来运行，请确保是在以下版本环境中安装使用:

  1. 64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。
  2. 64 bit JDK 17+；下载 & 配置。

2. 下载安装包

你可以通过Nacos官网网站及Github两种方式来获取 Nacos 发行包 。

进入Nacos官网[版本下载页面](/download/nacos-server/)，选择 [稳定版本](/download/nacos-server/#稳定版本)， 然后点击`二进制包下载`列中的`${nacos.version}.zip`进行下载。 
> 注意：有时大量用户同时进行下载时，可能会遇到下载限流失败的情况，若出现下载限流失败，请稍等后重试，或采用`从 Github 下载方式`。
进入Nacos Github 的 [最新稳定版本](https://github.com/alibaba/nacos/releases) ，选择需要下载的Nacos版本，在`Assets`中点击下载 `nacos-server-$version.zip` 包。

3. 解压缩Nacos 发行包

  unzip nacos-server-$version.zip 
  # 或者 tar -xvf nacos-server-$version.tar.gz
  cd nacos/bin

4.启动服务器

  • 注：Nacos的运行建议至少在2C4G 60G的机器配置下运行。
启动命令(standalone代表着单机模式运行，非集群模式): 
`sh startup.sh -m standalone`

如果您使用的是ubuntu系统，或者运行脚本报错提示[[符号找不到，可尝试如下运行：`bash startup.sh -m standalone`
启动命令(standalone代表着单机模式运行，非集群模式): 
`startup.cmd -m standalone`

随后启动程序会提示您输入3个鉴权相关配置（Nacos从3.0.0版本开始默认启用控制台鉴权功能，因此如下3个鉴权相关配置必须填写）如下所示：

`nacos.core.auth.plugin.nacos.token.secret.key` is missing, please set with Base64 string: ${your_input_token_secret_key}
nacos.core.auth.plugin.nacos.token.secret.key` Updated:
----------------------------------
`nacos.core.auth.server.identity.key` is missing, please set: ${your_input_server_identity_key}
`nacos.core.auth.server.identity.key` Updated:
----------------------------------
`nacos.core.auth.server.identity.value` is missing, please set: ${your_input_server_identity_key}
`nacos.core.auth.server.identity.value` Updated:
----------------------------------

:::note 若您已经在 conf/application.properties 中设置过这3个配置，则不会提示您输入。 :::

5.验证Nacos服务是否启动成功

进入${nacos.home}/logs/ 目录下， 使用tail -f start.out 查看日志，如果看到如下日志，说明服务启动成功。

Nacos started successfully in stand alone mode. use embedded storage

可以通过下列服务，快速检验Nacos的功能。

5.1. Nacos控制台页面

打开任意浏览器，输入地址：http://127.0.0.1:8080/index.html, 即可进入Nacos控制台页面。

注意：首次打开会要求初始化管理员用户nacos的密码。

5.2. 服务注册

curl -X POST 'http://127.0.0.1:8848/nacos/v3/client/ns/instance?serviceName=quickstart.test.service&ip=127.0.0.1&port=8080'

5.3. 服务发现

curl -X GET 'http://127.0.0.1:8848/nacos/v3/client/ns/instance/list?serviceName=quickstart.test.service'

5.4. 发布配置

# 登陆获取access token
curl -X POST 'http://127.0.0.1:8848/nacos/v3/auth/user/login' -d 'username=nacos' -d 'password=${your_password}'
# 使用access token，创建配置
curl -X POST 'http://127.0.0.1:8848/nacos/v3/admin/cs/config?dataId=quickstart.test.config&groupName=test&content=HelloWorld' -H "accessToken:${your_access_token}"

:::note 访问Admin API，默认需要使用access token, access token可通过POST /nacos/v3/auth/user/login接口获得 :::

5.5. 获取配置

curl -X GET 'http://127.0.0.1:8848/nacos/v3/client/cs/config?dataId=quickstart.test.config&groupName=test'

6.关闭服务器

6.1. Linux/Unix/Mac

sh shutdown.sh

6.2. Windows

shutdown.cmd

或者双击shutdown.cmd运行文件。

相关项目