使用 yourls 专属自己的短域名服务

YOURLS 是 Your Own URL Shortener,是一个非常强大的短链接平台。

官网地址:http://yourls.org

  • 基于 PHP 的免费开源短链接平台
  • 点击历史和频次统计、推介跟踪、访客地理位置等等
  • 有丰富的插件架构,可以更好地拓展功能
  • 方便的 API
  • 支持跨域访问
  • 安装配置方便

安装

手动安装

  • 从 Yourls 的 GitHub 主页 https://github.com/YOURLS/YOURLS/releases 下载最新版包;
  • 复制 /user/config-sample.php 到同目录下并改名为 config.php, cp /user/config-sample.php /user/config.php
  • 打开 vim config.php,根据个人情况进行数据库、管理员账户等配置;
  • 将所有文件上传到网站的根目录,可能是 public_html 或者 /var/www/ 等等;
  • 访问 http://your-own-domain.com/admin/ 来进行安装。

yourls 的用户名和密码是以字符串形式存放在配置文件中的,需要在设置时指定。

Docker

推荐使用 Docker 安装

配置

基本的配置可以分为三个部分

数据库设置

配置文件在目录下 /user/config.php

/** MySQL 数据库用户名 */
define( 'YOURLS_DB_USER', 'your db user name' );
/** MySQL 数据库密码 */
define( 'YOURLS_DB_PASS', 'your db password' );
/** 用来存储 Yourls 数据的数据库 */
define( 'YOURLS_DB_NAME', 'yourls' );
/** 如果你不是用的标准 hostname 端口,请用'hostname:port'这种格式配置,例如 'localhost:8888' 或者 '127.0.0.1:666' */
define( 'YOURLS_DB_HOST', 'localhost' );
/** MySQL 表前缀字符 */
define( 'YOURLS_DB_PREFIX', 'yourls_' );

站点设置

/** YOURLS 安装 URL -- 字母小写,并且结尾不带斜线
** 如果你想配置到 "http://sho.rt", 就不要在浏览器中用 "http://www.sho.rt"(反之亦然) */
define( 'YOURLS_SITE', 'https://your-own-domain.com' );
/** 服务器时区 GMT 值,北京时间 +8 */
define( 'YOURLS_HOURS_OFFSET', 0 );
/** YOURLS 语言
** 更改此项设置来使用你优先的语言翻译文件,默认语言为英语
** 翻译文件 (a .mo file) 需要提前放在 /user/language 目录下
** 通过查看 http://yourls.org/translations 获取更多翻译信息 */
define( 'YOURLS_LANG', '' );
/** 允许多个短链接对应同一原链接
** 设置为 true 则表示短链接和原链接一一对应(默认 Yourls 设置)
** 设置为 false 则允许多个短链接对应同一原链接(类似 bit.ly 表现) */
define( 'YOURLS_UNIQUE_URLS', true );
/** Private 表示后台管理需要密码登陆作为默认手段来实现管理
** 设置为 false 意味着对公众开放模式(例如在内网配置或者测试安装)
** 查看 http://yourls.org/privatepublic 获取更多细节 */
define( 'YOURLS_PRIVATE', true );
/** 用来加密 cookies 的一串随机哈希值,并不需要记住这个,要让它尽量长而复杂,可以从 http://yourls.org/cookie 来获取随机哈希值 **/
define( 'YOURLS_COOKIEKEY', 'modify this text with something random' );
/** 登陆管理站点的用户和密码,密码可以是纯文本或者加密的哈希值
** YOURLS 将会自动加密本文件中的纯文本密码
** 查看 http://yourls.org/userpassword 获取更多信息 */
$yourls_user_passwords = array(
'username' => 'password',
// 'username2' => 'password2',
// 你可以利用'login'=>'password'这种格式来添加更多行
);
/** 调试模式,用来输出一些内部信息
** 对于运行中的站点默认是 false,在编码或者获取提交信息时才会启用 */
define( 'YOURLS_DEBUG', false );

链接设置

/** 链接缩短方式:36 或者 62 **/
define( 'YOURLS_URL_CONVERT', 36 );
/*
* 36: 生成数字和小写字母组成的短链接关键字(例如:13jkm)
* 62: 生成数字大小写混合的短链接关键字(例如:13jKm 或者 13JKm)
* 选择一个来设置,你开始创建连接之后最好别再更改
*/
/**
* 保留关键字(这样子在创建链接时就会屏蔽这些关键字)
* 这里会填上负面、潜在误导性的词语
*/
$yourls_reserved_URL = array(
'porn', 'faggot', 'sex', 'nigger', 'fuck', 'cunt', 'dick',
);

主页设置

默认情况下如果安装了 yourls,那么 https://sho.rt 根目录是空的,如果不想要展示一个空空的根,可以在根目录下新建 vim index.php 加入以下内容

<?php
header("HTTP/1.1 301 Moved Permanently");
header("Location: http://yourdomain.com");
?>

修改用户名密码

yourls 中的密码可以直接修改 /user/config.php 文件中

<?php
$yourls_user_passwords = array(
    'name' => 'md5:71688:0ce4',
);

直接修改后面密码 hash 部分,再下一次启动时 yourls 会自动加密该密码

如果使用之前我的 Docker 方式安装的,需要在 docker-compose.yml 中设定好密码,这样重新启用 docker-compose 即可。

插件

官方在 GitHub 上总结了非常多的插件,可以根据自己的需求找到想使用的插件。

使用插件的基本流程如下,所有的插件都可以使用这样的方式安装启用:

  • 将插件拷贝到 /user/plugins/ 插件名 / 目录下
  • 然后在管理页面激活插件

Allow Hyphens in Short URLs

官方默认插件,允许在短域名中加入 - 短横线,有些时候为了易读性加上字符分割还是非常易识别的。

Random Keywords

默认 yourls 的短链接是数字递增的,随机短链接插件将短链接变成随机字符串。

YAPCache

将点击缓存,减少数据库读

YAPCache 是 Ian Barber’s YOURLS APC Cache 插件的 fork 版本,增加了缓存等等功能,不要同时安装这两个版本。

Conditional Toolbar

可以修改短域名的模式,比如将 https://sho.rt/abc 变为 https://sho.rt/m/abc 这样的模式,那么可以在 /m/ 下显示一个工具栏,不推荐使用,影响用户体验。

Qr code

在短链接后面添加 .qr 显示二维码

Public Prefix ‘n’ Shorten

处理 http://sho.rt/https://google.com 这样的链接不指向 admin

google-analytics-for-yourls

在 admin 中可以添加 track 变量,这个插件会添加一些 Google Analysis 的参数 GA campaign info,对于需要大量追踪信息的商家来说很好的插件。

google-analytics-yourls-plugin

给 stats & admin page 添加 GA 分析,只有当访问 https://gtk.pw/ins+ 这样带 + 号的短链接才会被追踪到 Google Analytics

在将 plugin.php 放到 user/plugin/ganalytics 目录下之后,需要在 config 文件中定义

define(GANALYTICS_ACCOUNT, "UA-XXXXXX-UU");

YOURLS-GA-MP-Tracking

另一个 GA track

什么时候使用短链接

短域名服务或许是兴起于 Twitter 只能写 140 个字开始,因为有限的文字数量,所以必须要非常有效的传递每一个信息,所有不能把文字浪费在长链接上,自从 t.co 开始就源源不断的开始涌现出各种各样的短链接服务,所以应该在什么时候使用这个服务呢,我总结了一下我个人用的几个情况

  • 需要追踪链接点击情况,虽然用 Google Analysis 也能够做,但是短链接明显更加简单
  • 需要隐藏掉长链接的尾巴,一方面是为了链接美观,一方面也是隐藏真实的长链接

301 和 302 跳转的区别

默认情况下 yourls 使用的是 301 跳转,但是这两个有着一定的区别,可能对于普通用户而言都是跳转,表现出来是一样的,但是对于搜索引擎,或者浏览器等等,他们的处理方式就有区别。

  • 301 表示这个页面地址已经永久的移动到了另一个地方
  • 302 表示这个页面临时被跳转到另一个地方

所以对于搜索引擎来说需要考虑是否要保留原始地址,或者是否要用新页面来替换老页面。而浏览器对于 301 跳转会进行缓存。

reference


2018-04-11 linux , docker , url-shorten , url , domain

域名相关网站及价格整理

前段时间关注了一下域名生意,然后自己也是因为腾讯的优惠券买了一个 club 的域名,看了这么多天的域名,而现在顶级域名又原来越多,虽然 .com 域名依然占据着互联网的绝对位置,但随着未来大家对互联网的认识加深,应该会普及开其他通用顶级域名,所以我感觉其实也没有必要屯一些特殊的域名,除非真的能够买到 a.liveyoutube.tv 这样的域名,其他的域名真的已经不重要了,前两年可能还有千万的域名价格成交,这两年都已经听不到了。如果真的有域名的需求,不妨考虑下品牌的名字,能够有 .com 域名最好,不然 youtu.be 不是也挺好。

域名注册局

腾讯云

垃圾腾讯云要不是有优惠券才不会使他。

https://buy.cloud.tencent.com/domain?price=1

Google Domains

这是Google域名的价格,大部分都是非常统一的,续费和转入都非常方便,提供免费的隐私包含和免费的域名邮箱转发

https://support.google.com/domains/answer/6010092?hl=en

namecheap

另一个比较著名的域名贩卖商

https://www.namecheap.com/domains.aspx#domain_tab_pricing

name.com

网址

https://name.com

namesilo

网址

https://www.namesilo.com/

域名价格对比

tld-list

网站地址

https://tld-list.com/

可以查看一千多个顶级域名在各个网站上的价格。

domcomp.com

网站地址

https://www.domcomp.com/

另一个域名比价网站,不管是新购还是renew都可以先上这两个网站看一眼,然后再选择转入到哪一家。

域名注册量统计

通用顶级域名注册信息

地址

https://ntldstats.com/

该网站上能看到全世界的域名注册量信息,包括注册局信息,顶级域名注册量信息。比如这里 就能看到Google刚开放的 .app 顶级域名的单日注册量。

域名是否被注册

特色后缀

fm

fm 是密克罗尼西亚国家顶级域名,当然fm也可以是调频广播,fm域名后缀非常适合拿来做广播网站,音乐广播网站。

dianying.fm
douban.fm
lizhi.fm
last.fm
yuedu.fm
987.fm
tingshuo.fm
qingting.fm
360.fm

fm 域名相对较贵,基础年费 60 刀以上

tv

.tv为吐瓦鲁国家及地区顶级域的域名,很容易让人联想到电视,视频等等,因此经常被用来做视频相关的站点。

pw

也是一个国家的顶级域名,不过有些废,因为 pw 啥都沾不上,所以也就便宜。


2018-04-10 domain , price , collection , registry , gtld , google , godaddy , namecheap

git 分支管理

提高分支管理,就不得不提Vincent Driessen很早之前提出的策略,他提出来几点

  • 唯一主分支
  • 开发分支,日常开发,发布 nightly
  • 临时分支,功能分支从 develop 分支拉,预览版分支从最新 develop 拉,bug修补分支从 master 拉及时修复合并到master和develop

下面沿着经典的 master 和 dev 分支模型,讲两点保证 history 干净的方法。

小型feature使用 squash merge

小型 feature,or bug,能够在几小时内解决的 branch,可以使用 squash merge

# under master
git merge --squash private_feature_branch

大型 feature 使用 rebase 整理 history

对于大型分支,大型功能,可能需要花费长时间 working,需要提交数百次commit的分支,那么使用 squash 可能会导致一次提交有成千上万行代码,非常不利于 code review。那么这个时候就需要使用 rebase 的交互模式。可以参考之前的文章 来学习一下rebase基本的使用。

rebase 的交互模式非常强大,可以用来修改过去的提交,分割提交,合并提交,甚至重新排序提交。

# on feature branch
git rebase --interactive master
git rebase -i master

当使用交互式rebase时,会显示一个编辑器,其中包含了一系列的命令和提交,比如下面三次提交,默认都为 pick,表示不修改该 commit,

pick 9c422c5 Fix bug
pick 8821164 Change html
pick 89e9f73 Update

将第二次提交修改为 s, squash,并保存

pick 9c422c5 Fix bug
s 8821164 Change html
pick 89e9f73 Update

那么第二次提交就会合并到第一次提交,最下面的提交为最新的提交,从上到下为旧->新,当保存退出时会弹出新的编辑器,可以在该编辑器中,书写新的提交信息,然后保存。

不过需要注意的是,永远不要改写 public 或者 master 已经发布的分支

经典分支模型的问题

这几点都是老生常谈的要点了,经典的分支模型理论上除了 master 和 develop 分支外,其他分支都不应该存在于远程仓库中。当然理论和实际总是有出入的。Vincent Driessen 的分支模型固然合理,但是并不能满足所有的开发需求。

  • 当大型 feature 的合并,可能导致 master 分支 build 失败,这个过程也就违背了如今的软件开发持续集成的思路,经常将修改集成到现有的系统中,可以尽早的发现错误
  • 如果使用 --no-ff 来合并分支,会出现额外的 Merge branch xxx of git@github.com 这样的无意义的 commit 出现,导致 master 线非常杂乱

解决经典分支模型的问题

考虑所有开发都在 master 进行

如果考虑所有的开发都在 master 上进行,本地开发者需要经常 git rebaseorigin/master 上最新内容拉到本地,开发者推荐在本地维护小型的分支,一旦有可使用的代码立即提交到 master 中持续集成,从提交到合并中间可以加上 review 和 test 。

避免使用共享的远程分支

当所有的开发都在 origin/master 上进行时,开发者需要将所有的修改在最新的远程master上惊醒,以保证每次的开发都能够正常被合并而不会产生冲突。保证了这一点就可以避免在大量feature分支合并时产生的 integration hell

如果使用 Gerrit,或者 Phabricator 等等 code review 工具那么这些集成就更方便了

从 origin/master 发布 release

每一个发布都有自己的 tag,并且有独立于 origin/master 的分支,加入有 hotfix,那就直接添加到 release 分支,并且 cherry-pick 到 master 分支。如果使用固定的 tag 和 分支命名方法,可以使用CI自动针对 tag 发布,整个过程对开发流程透明,开发者甚至可以不关心发布,而只关心 tag,让后面的流程自动在 CI 中执行。

只使用 fast-forward merges

避免大量的无意义的 merge commits 将仓库搞的乱七八糟,只使用 git rebase 或者 git cherry-pick ,rebase 可以让历史提交线非常清晰,这样 git bisect 也能快速的定位到问题。

如果使用了 Gerrit,那就意味着提交了一组 commit 到 origin/master,你可以使用 cherry-pick 来任意调整 commit 的顺序。

reference


2018-04-09 linux , git , github , branching , svn , version-control

私人网盘 NextCloud

NextCloud 就不多介绍了,把他看成一个 Dropbox 的私人托管版本,相比于将数据交给 Dropbox ,NextCloud 则需要自己负责自己数据的安全。这里记录下使用过程中的一些问题吧。

安装

推荐使用 Docker compose 来安装 熟悉 Docker 的情况下,基本上是一键安装的。

docker-compose up -d

然后享受 NextCloud 带来的极速体验吧。

关于插件

虽然默认 NextCloud 自带的插件已经非常丰富了,但是有些功能还是需要一些插件才能完成,幸好 NextCloud 的插件库已经非常丰富,直接 admin 后台点击安装即可。我在使用过程中,发现视频,文档都可以预览,而 mp3 文件点击之后竟然直接给下载了,所以找到了 audioplayer 这样一个插件,可以让我在线预览歌曲。

而关于其他的安全的,媒体的很多插件都可以在插件库或者应用库中找到。二步验证的推荐安装。

关于使用

NextCloud 的权限管理已经非常详细了,公开分享,私密密码分享,过期时间,完全能够满足所有的分享需求,在看使用 Manual 的时候,发现 NextCloud 和 Dropbox 一样可以设置一个公开文件夹,然后别人可以通过该文件夹来给你上传文件,这个也是非常不错的了。

关于客户端

除了 Dropbox 那么良心,所有平台都提供客户端之外,我也只有见到 NextCloud 那么良心提供全平台的同步客户端了。

sudo add-apt-repository ppa:nextcloud-devs/client
sudo apt-get update
sudo apt install nextcloud-client

PPA 中安装,也可以直接下载 AppImage。其他两个平台就直接安装就行。

来最后给大家分享一首歌:https://nc.einverne.info/s/SbN7zYBKiHMeWs5

总结

因为所有的数据都需要自己来保管安全,所以一方面要做到服务器的安全,另一方面也要保证 NextCloud 的安全,到目前为止,我还是依然使用 Dropbox 作为主要个人存储同步,NextCloud 作为 backup。如果你从来没有听说过 Dropbox 那么可以使用我的邀请 https://db.tt/isyvu6ny 来注册,你我都可以多得 500M 空间。对我而言这 500M 的空间远比某盘 1T 的空间要重要的多。如果你认为 Dropbox 仅仅是一个同步盘的话,请参考下这篇 文章,你不仅能够拿 Dropbox 来托管静态文件,甚至可以借用 IFTTT 来完成很多意想不到的事情。


2018-04-08 linux , nextcloud , dropbox , file-sharing , file-syncing , self-host

关于通用顶级域名 .xyz

为什么现在这个时机突然关注了 .xyz 这个域名呢,最直接的原因是,疼讯云给了我100元的优惠券,看了一圈续费VPS似乎不太划算,算来算去也只有购买一个域名值得一些,但是看了一圈疼讯提供的顶级域名,.cn 臭名远扬是不会买的,.com 几乎已经注册不到好记的域名了,.info 我自己有了一个einverne.info 再买个似乎也不知道买什么好了,于是 .xyz 这个很显眼的域名成为了我考虑的目标。然后突然想起来字母表公司(对就是那个 alphabet 公司),他的官网是 https://abc.xyz 好记又贴合名字,顿时看到了希望。

关注域名的人应该会经常看到这个词 gTLD, 全称是 generic Top Level Domain,中文是通用顶级域名,通俗的来讲也就是我们经常遇到的 .com, .net, .org 等等域名后缀。不同国家有自己的国家顶级域名,比如中国的 .cn,还有美国的 .us,还有日本的 .co.jp 等等,不同的行业机构也都有不同的后缀,一般学校教育机构会有 .edu,政府机构会有 .gov,军事机构会有 .mil 等等。1

提到 .xyz 域名就不得不提到 Daniel Negari ,在无数的报道中,Negari 因为独到的眼光预先将 .xyz 的通用顶级域名给注册了,所以让 .xyz 变得成为 .com 之后渐渐流行的通用顶级域名。他在采访中说的最多的一句话就是字母表既然以 .xyz 结尾,那么域名也应该如此2。在 Google 重组还没有使用 abc.xyz 域名前,每天有 3000 多注册,而 Google 重组成 Alphabet 之后每天的注册量已经上升到 10000.

很多人追问的一个问题就是 .xyz 域名会不会火,其实面对着越来越多的通用顶级域名,其实原本稀缺的 .com 域名早已经成为了互联网的历史,如果说以前人们还只认识 .com, .org 那么互联网的使用者是会变的,当足够多的人认可了以顶级域名,那么自然不在会有一个 .com 的域名再能够卖几千万几百万了。

注册通用顶级域名

想必看到这里很多人会想问,与其说去买一个 .com 的域名,还不如自己去注册一个顶级域名,其实注册顶级域名是有门槛的, ICANN 每几年都会开放一次注册,比如 .xyz 就需要 $185,000 来获取。如果想要获取自己的 gTLD,那么需要提交一份完整的申请,还有准备好大约 $200,000 美金,当然还要排除掉你想要注册的顶级域名没有人来和你抢。ICANN 有一份简单的说明几乎可以涵盖经常被问到的事情。

关于起名

Paul Graham (著名初创企业投资人)在他自己的博客 写过关于初创企业命名相关的内容,他说“如果你开始了一个 X 企业,但是你拿不到 X.com,那么你就应该考虑改名字”,这一句话不仅道出了 .com 域名在互联网的地位,也让我们看到了起名对一个企业的重要程度,也才会出现天价的域名购买。

于是我就顺着这个线索,找了一些有意思的企业,找一找他们的名字的由来,Google 自然不比说,于是我先找到了 Trello ,之前 也介绍过的一个看板类应用。在 Quora 上面我找到了这样一篇文章,经历过早期创业的人提到了他们苦恼如何命名自己的产品,从内部代号 Trellis ,到他们雇一名专业起名的人给出 “lasagna” ,到全公司头脑风暴给出各种谐音,日语结合,单词拼凑, Kardboard,Hippolist,Listly,Idealist,经过无数的讨论,他们甚至想要去买 trell.is 域名,但是价格无法接受,最终在没有给注册的 .com 与域名中,他们找到了 trello.com 。那一切讨论就终止了。

还有Amazon 原来叫 Cadabra.com ,但是因为不好记,很快就被淘汰了。后来 Bezos 自己发现了 amazon.com 3

reference


2018-04-07 domain , google , alphabet , hooli , xyz , gtld

使用 Travis 自动部署静态网站到 GitHub Pages

GitHub Pages 可以用来托管静态网站,而 Jekyll,Gitbook 等等程序都可以生成静态网站,那么如果使用 master 分之托管源码的话, gh-pages 分支就可以用来托管静态网站。而使用 Travis 就可以将每一次 master 分支的提交,自动编译静态站点之后提交到 gh-pages 分支。

既然要使用到 git 的推送,那么必然避不了需要验证,Travis 提供很多验证方式,这里有两种:

Encryption keys

加密 TOKEN,需要使用到 GitHub 提供的 Personal API tokens,Token 与 帐号密码 以及 SSH Keys 同样具有 Github 写入能力,因此只要使用 Travis CI 提供的加密工具来加密这个 Token 即可。

Travis CI 会使用一对密钥中的 Public Key 来加密提供的 TOKEN,然后得到的 secure token 可以安全地放在 .travis.yml 文件中,在 Build 的时候 Travis 会使用 Private Key 来解密这个 Secure Token 获取最初提供的 Github Personal Access Token,并使用该 TOKEN 来进行一系列操作。

操作具体步骤:

  1. 获取 GitHub Personal access tokens https://github.com/settings/tokens, Github 帐号 Settings 页面侧边栏最下面 Developer 中有 Personal access tokens。新建一个 token,只需要选择 repo 相关权限。创建完的 token 只会显示一次,保存好该 token 下面需要使用。
  2. 安装 travis 工具,需要提前安装好 Ruby 环境 gem install travis
  3. 使用 GitHub TOKEN 来登录 travis login --github <token>
  4. 生成 secure token travis encrypt GH_TOKEN=<token> ,使用 travis encrypt ... 命令会生成加密的字符串,把字符串添加到 .travis.yml 文件中

或者使用额外的参数 --add ... 比如 travis encrypt <token> --add deploy.github-token 可以自动添加到 .travis.yml 文件中,会自动在 deploy 下创建 github-token 来存放加密字符串。

更多的 travis 的使用可以 travis -h 来查看。

下面以 Gitbook 使用 Travis 自动编译部署到 GitHub Pages 为例,这里使用到了 Travis 的发布到 GitHub Pages 的功能

language: node_js

node_js:
  - "8"

before_install:
  - export TZ='Asia/Shanghai' # 更改时区

# 依赖安装
install:
  - npm install gitbook-cli -g
  # 安装 gitbook 插件
  - gitbook install

# 构建脚本
script:
    # 自定义输出目录 gitbook build src dest
    # 默认会输出到 _book 目录下
  - gitbook build .

# 分支白名单
branches:
  only:
    - master # 只对 master 分支进行构建

before-deploy:
- git config --local user.name "Ein Verne"
- git config --local user.email "git@einverne.info"

# GitHub Pages 部署
deploy:
  provider: pages
  skip_cleanup: true
  github_token:
    secure: <secure token>
  # 将下面的目录中内容推送到 gh-pages 分支
  local_dir: build
  fqdn: $CUSTOM_DOMAIN
  name: $GIT_NAME
  email: $GIT_EMAIL
  on:
    branch: master

大概原理就是如此,记住 skip_cleanup: true 这个一定要写上,否则 Travis 在 build 的时候会自动清理掉 repo 中编译生成的内容。

  • before_install 在安装之前,设置时区
  • install 安装依赖
  • script 执行真正的脚本
  • before_deploy 部署之前做的事情
  • deploy 部署发布内容

验证 travis 配置

本地使用命令

travis lint .travis.yml

实例使用可以参考这个例子

reference

  • https://www.jianshu.com/p/5f96c27baaa5

2018-04-06 github , git , travis , github-pages , jekyll , gitbook

Gitbook 使用记录

Git 本来是一个版本控制工具,多人协作工具,但却爆发出无限的潜能,于是有人开始使用Gitbook来写书,设计师们用Git来管理版本。这篇文章主要就是想要介绍一下 Gitbook 的简单使用。

Gitbook 使用 Markdown 作为书写格式,Git 来做版本控制,结合两者来编排书籍。Gitbook 的安装非常方便,在本地有 Node.js 和 npm 的环境下

npm install gitbook-cli -g
gitbook -V  # 检查版本

就能够安装 gitbook 命令。

Gitbook.com 是一个发布 gitbook 编写书籍的在线网站,提供公开和私有的托管服务,和 GitHub 一样,私有的 Gitbook 是需要付费使用的。但是公开的书籍是无上限的,使用在线的 Gitbook 可以让未接触过 Git 和 Markdown 的作者轻松的创建书籍,并且在线的编辑器可以让作者安心的只关心内容,而不必在意排版,并且支持多人协作编写。

  • GitBook项目官网:http://www.gitbook.io
  • GitBook Github地址:https://github.com/GitbookIO/gitbook

使用

gitbook 的使用可以简单的归纳为如下两步:

  • 使用 gitbook init 初始化书籍目录
  • 使用 gitbook build 编译书籍到静态网站
  • 使用 gitbook serve 本地访问书籍

在使用 gitbook init 之后本地会生成两个文件 README.mdSUMMARY.md ,这两个文件都是必须的,一个为本书介绍,一个为本书目录结构。

gitbook 插件

Gitbook 拥有很多插件来扩展 Gitbook 的功能,比如支持数学公式,支持Google统计,评论等等。插件可以在 https://plugins.gitbook.com/ 找到。

插件安装比较简单,在目录下添加 book.json 文件,填写下面格式

{
    "plugins": ["plugins1", "plugins2"],
    "pluginsConfig": {
        "plugins1": {...}
    }
}

注册完插件之后,安装插件 gitbook install。 插件开发可以参考官方文章

常用插件

如果不需要使用 Gitbook 自带的插件可以使用 - 来排除

"plugins" : [ "-search" ]

如果想知道更多关于 Gitbook 的使用,以及各种插件,主题的使用,可以具体参考 https://einverne.github.io/gitbook-tutorial

reference


2018-04-05 gitbook , git , github , book , publish

每天学习一个命令:vmstat 查看系统资源使用情况

vmstat 是一个收集和报告系统内存,swap,处理器资源的工具。

vmstat reports information about processes, memory, paging, block IO, traps, disks and cpu activity.

使用

vmstat 的使用非常简单,直接运行

vmstat
procs -----------memory---------- ---swap-- -----io---- -system-- ------cpu-----
 r  b   swpd   free   buff  cache   si   so    bi    bo   in   cs us sy id wa st
 2  0   9496 1632720 1179760 4628968    0    0     9    37   55   12  3  1 96  0  0

输出一大串数据,这一串数据是 vmstat 从开机到运行命令之间记录的平均数据。

vmstat [delay] [count]

第一行会打印平均值,之后每隔 [delay] 的时间,打印一次报告,在打印 [count] 次之后停止。

输出值解释

Procs
   r: The number of runnable processes (running or waiting for run time).
   b: The number of processes in uninterruptible sleep.

Memory
   swpd: the amount of virtual memory used.
   free: the amount of idle memory.
   buff: the amount of memory used as buffers.
   cache: the amount of memory used as cache.
   inact: the amount of inactive memory.  (-a option)
   active: the amount of active memory.  (-a option)

Swap
   si: Amount of memory swapped in from disk (/s).
   so: Amount of memory swapped to disk (/s).

IO
   bi: Blocks received from a block device (blocks/s).
   bo: Blocks sent to a block device (blocks/s).

System
   in: The number of interrupts per second, including the clock.
   cs: The number of context switches per second.

CPU
   These are percentages of total CPU time.
   us: Time spent running non-kernel code.  (user time, including nice time)
   sy: Time spent running kernel code.  (system time)
   id: Time spent idle.  Prior to Linux 2.5.41, this includes IO-wait time.
   wa: Time spent waiting for IO.  Prior to Linux 2.5.41, included in idle.
   st: Time stolen from a virtual machine.  Prior to Linux 2.6.11, unknown.

2018-04-04 linux , vmstat , memory , swap , processor

每天学习一个命令:parted 在 Linux 下给硬盘分区

parted 是 GNU 组织开发的一款功能强大的磁盘分区和分区大小调整工具,命令可以对磁盘进行分区和管理,和 fdisk 相比,能够支持 2T 以上磁盘。它可以处理最常见的分区格式,包括:ext2、ext3、fat16、fat32、NTFS、ReiserFS、JFS、XFS、UFS、HFS 以及 Linux 交换分区。

功能特点:

  • 能够创建、清除、调整、移动和复制 ext2, ext3, ext4, linux swap, fat32, ntfs 等分区
  • 能够重新分配磁盘使用情况

parted 有两种使用方式

命令行方式

定义分区表格式

parted -s /dev/sda mklabel gpt

划分主分区

parted -s /dev/sda mkpart primary ext4 1 10G

划分逻辑分区

parted -s /dev/sda mkpart logic 10G 20G

查看分区情况

parted -s /dev/sda p

直接使用一行命令来完成分区操作

parted /dev/sdb mklabel gpt mkpart 1 ext4 1 5T

交互命令方式

使用 parted /dev/sdb 来进入对 /dev/sdb 硬盘的管理。

在交互命令下可以使用如下命令

交互命令 功能
mklabel gpt 定义分区表格式,常用的有 msdos 和 gpt 分区格式,2T 以上硬盘选用 gpt
mkpart p1 创建第一个分区,名称为 p1,在使用该命令后会选择分区的格式,分区起始位置,分区的结束位置
print 查看当前分区情况
rm 删除分区,之后会选择想要删除的分区‘
help 帮助

在划分分区之后,可以使用

mkfs.ext4 /dev/sdb1

来针对 sdb 磁盘上第一块分区进行格式化。然后挂载分区 mount /dev/sdb1 /mnt/sdb1

对于一块新的硬盘,如果没有 GUI 的界面来进行格式化,就需要用到这个命令了。


2018-04-03 linux , parted , gparted , partition , clonezilla

Linux 交换分区

Linux 内核为了提高读写效率与速度,会将文件在内存中进行缓存,这部分内存就是 Cache Memory(缓存内存)。即使你的程序运行结束后,Cache Memory 也不会自动释放。这就会导致你在 Linux 系统中程序频繁读写文件后,你会发现可用物理内存变少。

Linux divides its physical RAM (random access memory) into chucks of memory called pages. Swapping is the process whereby a page of memory is copied to the preconfigured space on the hard disk, called swap space, to free up that page of memory. The combined sizes of the physical memory and the swap space is the amount of virtual memory available.

Swap space in Linux is used when the amount of physical memory (RAM) is full. If the system needs more memory resources and the RAM is full, inactive pages in memory are moved to the swap space. While swap space can help machines with a small amount of RAM, it should not be considered a replacement for more RAM. Swap space is located on hard drives, which have a slower access time than physical memory.Swap space can be a dedicated swap partition (recommended), a swap file, or a combination of swap partitions and swap files.

Linux 通过一个参数 swappiness 来控制 swap 分区使用情况,swappiness 是控制系统使用 swap 分区的频率阈值,当 swappiness = 100 时,系统会积极使用 swap 分区,而当 swappiness = 0 时,系统会最大限度的使用物理内存。

Swappiness is a property for the Linux kernel that changes the balance between swapping out runtime memory, as opposed to dropping pages from the system page cache. Swappiness can be set to values between 0 and 100 inclusive. A low value means the kernel will try to avoid swapping as much as possible where a higher value instead will make the kernel aggressively try to use swap space. The default value is 60, and for most desktop systems, setting it to 100 may affect the overall performance, whereas setting it lower (even 0) may improve interactivity (decreasing response latency.)[1]
In short:
vm.swappiness = 0 - it will swap only to avoid an out of memory condition
vm.swappiness = 60 - default value
vm.swappiness = 100 - it will swap aggressvely
To temporarily set the swappiness in Linux, as root you set the value to 100 with the following command: echo 100 > /proc/sys/vm/swappiness
Permanent changes are made in /etc/sysctl.conf via the following configuration line (inserted if not present previously): vm.swappiness = 100

临时修改 swappiness 值可以通过以下两种方式:

手动修改文件

vim /proc/sys/vm/swappiness
# or
echo 10 > /proc/sys/vm/swappiness

或者

sysctl vm.swappiness=10

永久修改 swappiness 参数的方法就是在配置文件 /etc/sysctl.conf 里面修改 vm.swappiness 的值,然后重启系统

echo 'vm.swappiness=10' >>/etc/sysctl.conf

swap 分区操作

查看 swap 分区大小及使用情况,使用 free 命令

free -h

也可以使用 swapon 查看 swap 分区信息

swapon -s                   # --summary 显示 swap 的使用情况
swapon --show               # 显示结果更好看

也可以直接查看文件

cat /proc/swaps             # 和 swapon -s 相同

关闭交换分区

swapoff /dev/mapper/VolGroup00-LogVol01

缩小 swap 分区

lvreduce -L 8G /dev/mapper/VolGroup00-LogVol01

格式化 swap 分区

mkswap /dev/mapper/VolGroup00-LogVol01

启动 swap 分区,并增加到 /etc/fstab 自动挂载

swapon /dev/mapper/VolGroup00-LogVol01

swap 分区建立

在装完 Linux 系统之后,建立 Swap 分区有两种方法:

  1. 新建磁盘分区作为 swap 分区
  2. 用文件作为 swap 分区

swap 分区大小设置

4G 以内的物理内存,SWAP 设置为内存的 2 倍。
4-8G 的物理内存,SWAP 等于内存大小。
8-64G 的物理内存,SWAP 设置为 8G。
64-256G 物理内存,SWAP 设置为 16G。

新建磁盘分区作为 swap 分区

以 root 身份登入控制台,输入

swapoff -a              #停止所有的 swap 分区

用 fdisk 命令对磁盘进行分区,添加 swap 分区,新建分区,在 fdisk 中用”t”命令将新添的分区 id 改为 82(Linux swap 类型),最后用 w 将操作实际写入硬盘

fdisk /dev/sdb

格式化 swap 分区,这里的 sdb2 要看您加完后 p 命令显示的实际分区设备名

mkswap /dev/sdb2

启动新的 swap 分区

swapon /dev/sdb2

为了让系统启动时能自动启用这个交换分区,可以编辑 /etc/fstab, 加入下面一行

/dev/sdb2 swap swap defaults 0 0

使用文件作为 swap 分区

创建要作为 swap 分区的文件:增加 1GB 大小的交换分区,则命令写法如下,其中的 count 等于想要的块的数量(bs*count= 文件大小)。

dd if=/dev/zero of=/root/swapfile bs=1M count=1024

格式化为交换分区文件:

mkswap /root/swapfile #建立 swap 的文件系统

启用交换分区文件:

swapon /root/swapfile #启用 swap 文件

使系统开机时自启用,在文件 /etc/fstab 中添加一行:

/root/swapfile swap swap defaults 0 0

2018-04-02 linux , swap , partition

电子书

最近文章

  • Linux 下使用 emoji Ubuntu 或者其他一些 Linux 发行版会内置 Google Noto Color emoji font
  • 理解 GraphQL Schema 结构定义 在上一篇 GraphQL 使用 中了解了 GraphQL 大致用法,如果要更加深入的了解 GraphQL ,那就不得不重新从 Schema 来认识 GraphQL,说到底 GraphQL 还是一个强类型定义,客户端可操作的类型都是需要提前定义好的,这个结构就是这篇文章的重点 Schema.
  • 从 MySQL 迁移到 PostgreSQL 方案调研 之前的文章 PostgreSQL 初识 和 PostgreSQL 数据类型 大致的把 PostgreSQL 了解了一下,那么接下来就是真正地把它用起来。
  • GraphQL 使用 很多人都知道 GraphQL 起源于 Facebook,但是似乎很少中文材料提到 GraphQL 出现的契机,我在看完这个纪录片 之后才对 GraphQL 的出现有更加深刻的了解。都知道当年 Facebook 的移动客户端都是网页,随着移动互联网发展,Facebook 网页实现的客户端性能和体验受到非常严重的影响,所以后来不得不去做原生的应用。那么这个时候就遇到了一个问题,原来直接使用网页,那么不同客户端用的接口都是给网页用的,最多做一下屏幕的适配,但是如果使用原生的应用,那么必然会需要设计不同的 API,而 Facebook 的工程师发现,对于复杂的 Feed 流,评论等等,用 RESTful 接口将是一个灾难,所以一帮人开始设计一种查询语言,这就是后来的 GraphQL。也应该纠正一下 Facebook 那帮工程师,只是开源了一份设计和一份实现,但他们万万没有想到开源社区的力量,就像片中 Nick Schrock 说的那样,他低估了社区的力量,在短短的几个月,几年时间中,GraphQL 就已经有了非常多语言的支持,周边应用也非常丰富。原来在脑海里的想法,都没有到生产环境中用过,就这样在所有社区的人的努力下成为了改变这个行业的一部分。
  • Drools : Guided Decision Table Column