Go to file

以诺书 a9b0532424 更新 'readme.md'		2023-02-11 18:08:56 +08:00
as	change	2023-02-10 23:20:58 +08:00
readme.md	更新 'readme.md'	2023-02-11 18:08:56 +08:00

readme.md

ISPInfo Help

什么是ISPInfo？

ISP Info是由LaysenseCloudGlobal和PublicMirrorsNetwork联合主导的ISP和ASN信息数据库。致力于通过共享和整合信息构建更好、更开放、更透明的互联网。

我们不仅仅着眼于传统BGP数据库提供的ASN基础数据，而是以ASN为单位，以用户体验为基准，通过数据开源、任何人都可以编辑的Wiki百科式方式，把ISP的实际用户体验和连接质量作为关键点，构建一个真正开放、有效的ISP信息数据库。

如何查看数据信息？

您可以前往我们的网站访问ASN的信息

如： AS4134

https://ispinfo.de/as/4134

当然您也可以直接查看我们的官方仓库，直接查看原始MarkDown文件

数据源码结构?

目录结构

数据仓库目录由AS开头，结构类似于以下：

└── as
	├── ……
    │   ├── content.md
    │   └── info.json
    ├── 4134
    │   ├── content.md
    │   └── info.json
	├── ……
    │   ├── content.md
    │   └── info.json
    ├── 4294967293
    │   ├── content.md
    │   └── info.json
    └── readme.md

其中的数字为ASN,content.md为内容markdown，info.json为元数据

如中国电信AS4134的元数据则位于 /as/4134/info.json

元数据格式

元数据为json结构，类似于以下：

{
    "asn":4134,
    "name":"ChinaTelecom",
    "keywords":"ChinaNet,163,中国电信,电信,CN,CT",
    "logo":"https://pic3.zhimg.com/v2-b9d4027dd2da33f4ea66dddbc6d94a07_xll.jpg"
}

其中：

asn 为AS号

name 为该ASN对应的网络名或组织名

keywords 为检索该ASN所需要的关键词，可以缩写、不同语言的名称、曾用名、网络号缩写或昵称、别称构建。用英文逗号,隔开

logo 为该ASN的logo网址，若无，可留空。上传图片请参考本文的 "图片上传" 章节

内容格式

内容content.md为标准markdown，但有以下说明：

请尽可能避免行内代码，由于解析器的问题，前端渲染器无法正确解析行内代码，将作为代码框使用
请不要使用markdown extra语法和TOC、MindMap等拓展语法，目前解析器暂时仅支持Markdown标准语法。
请尽可能满足内容规范
包含图片请参考本文的 "图片上传" 章节

如何编辑数据库信息?

我们推荐的方式为通过Git提交PR合并请求，当然您也可以通过我们的在线编辑器提交代码。

如果您不更新元数据，只更新md文件内容，您也可以使用Gitea的在线编辑并创建PR请求。

任何的修改编辑都将经过管理员的人工审核，请您耐心等待。如若被驳回(几率不大，一般是格式问题)，请您不要气馁，并请您谅解。

在线编辑提交：

该方法只需要您有一个邮箱，不需要额外注册LaysenseRepo(Gitea)账号

您可以直接进入 https://ispinfo.de/edit/<要修改的ASN>

如：AS4134

https://ispinfo.de/edit/4134

填写完成后，ISPInfo将自动以ISPInfo的身份提交一个分支和PR请求，同时发送该PR请求的链接到您的邮箱。

请注意这种方法是不推荐的，我们的系统并不完善可能出现问题。此外该方式仅支持单个文件修改。

使用该方法，您的芳名则不会被记录在历史记录中

Git本地批量修改[推荐做法]:

该方法需要您注册一个LaysenseRepo(Gitea)账号，当然您也可以直接使用Github账号快速注册登录。

注册一个LaysenseRepo账号，如您欲通过邮箱和账号密码注册，请前往注册页面。如您打算通过Github账号快速注册登录，请访问登陆页面，并点击登陆方式中的Github图标或直接点击此处授权绑定您的Github账号
登录您刚刚注册的账号。
对官方仓库进行fork(派生)，您应当进入官方仓库，然后如下图所示点击右上角的fork(或派生)按钮
在弹出的新页面中点击左下角的fork(或派生)按钮
完成步骤4后页面将自动跳转至您Fork派生出的仓库，复制您的仓库Git链接
在本地命令行中输入如下命令，clone远程仓库，请将<git url>替换为您在第五步中获取的仓库GIT链接

git clone <git url>

如若提示 git command not found 请检查系统是否已安装git 您可以使用 yum install git 或 apt install git 安装 7. 通过cd命令进入目录，并修改您需要编辑的内容。您可以一次性批量编辑文件。 8. 完成后，输入以下命令保存

git add .
git commit -m "your message"
git pull https://git.laysense.com/enoch/ISPinfo.git master
git push <git url>

输入完成后如不出错，命令行将提示输入LaysenseRepo的用户名和密码

现在，前往您刚刚在LaysenseRepo上fork派生出的仓库地址，刷新页面，查看并确认内容修改是否被推送成功
如果上述步骤均无问题，请前往[官方仓库的合并请求(Pull Requests)页面] 点击右侧的"创建合并请求"按钮，在如下图所示的页面中，选取 "拉取从(Pull From)" 并改为含有您自己账号的、您自己Fork派生建立的分支
如果该页面没有显示任何错误，点击"创建合并请求"按钮以提交一个合并请求。然后您应当在界面中编辑一个标题和内容，简要描述您更改了哪些内容、更改的原因，这有助于加快我们的审核进度。
确认无误后，点击页面下方的"创建合并请求"按钮。当您的PR请求有任何状态更新时，系统都会发送邮件通知您。

Git在线修改:

该操作类似于Git本地批量修改，也需要一个LaysenseRepo账号。但您本地无需安装git客户端，也不需要使用cli，您可以直接在web上修改。

注册一个LaysenseRepo账号，如您欲通过邮箱和账号密码注册，请前往注册页面。如您打算通过Github账号快速注册登录，请访问登陆页面，并点击登陆方式中的Github图标或直接点击此处授权绑定您的Github账号
登录您刚刚注册的账号。
对官方仓库进行fork(派生)，您应当进入官方仓库，然后如下图所示点击右上角的fork(或派生)按钮
在弹出的新页面中点击左下角的fork(或派生)按钮
完成步骤4后页面将自动跳转至您Fork派生出的仓库以上步骤均与Git本地批量修改相同。
在您fork派生出的仓库中的代码页面浏览并找到您需要编辑的内容。
如图所示点击右上角的编辑图标按钮，并编辑内容
如图，编辑完成后点击 "直接提交至master分支" 选项
后续步骤与Git本地批量修改一致，前往您刚刚在LaysenseRepo上fork派生出的仓库地址，刷新页面，查看并确认内容修改是否被推送成功
如果上述步骤均无问题，请前往[官方仓库的合并请求(Pull Requests)页面] 点击右侧的"创建合并请求"按钮，在如下图所示的页面中，选取 "拉取从(Pull From)" 并改为含有您自己账号的、您自己Fork派生建立的分支
如果该页面没有显示任何错误，点击"创建合并请求"按钮以提交一个合并请求。然后您应当在界面中编辑一个标题和内容，简要描述您更改了哪些内容、更改的原因，这有助于加快我们的审核进度。
确认无误后，点击页面下方的"创建合并请求"按钮。当您的PR请求有任何状态更新时，系统都会发送邮件通知您。

图片提交

您可以前往我们的官方图床 www.Bed.pics 提交图片。建议您注册账号登陆后再提交图片。请勿滥用。

测试ASN

为了方便您熟悉系统进行测试，我们特意留存了一个测试用ASN，该ASN内容可以任意更改，不受审核和内容规范限制。
建议您初次进行修改编辑时选择测试ASN，以免发生意外。
测试ASN为：
4294967293

readme.md Unescape Escape