前端错误日志上报及网站统计(sentry+matomo)

发布于

本文配合 rancher1.6(手头一个测试集群没升级到最新的 2.x)讲解如何搭建并配置日志错误上报框架Sentry及网站统计分析框架matomo 的搭建及接入 vue(本文以iview-admin为例)项目。

背景简述

  • sentry 项目运行过程中，难免出现 bug，前端不像后端可以很方便的采集项目日志(比如 log4j + elk)，导致每次出问题后还原车祸现场费时费力。另外现在随着 vue 等兴起，构建项目时打成 min.js，无疑又加大了前端定位问题的难度。而 sentry 是一款专注于错误采集的框架，支持常见的主流语言image.png采集，聚合，并推送错误信息。注意，sentry 并不是日志平台(e.g. log4j + elk)，也不是监控平台，sentry 专注于项目中的 Error 信息的采集，聚合，报警。
  • matomo 前身 Pwiki，是一款开源的 web 网站分析利器。类似于 Google Analytics。具体的特性，参见 Premium Web Analytics ，比如绘制页面热力图，录制会话，访问漏斗，A/B Test 等(这几样都是收费插件功能)。

注意：本文假设你已经有 rancher1.6 的环境

安装

matomo

rancher 创建 matomo

在 rancher 主机上

## 创建必要文件夹
mkdir -p /data/matomo/{config,logs,php,maxmind}/

## 安装maxmind ip数据库
wget -P /tmp/ https://github.com/maxmind/geoipupdate/releases/download/v4.0.3/geoipupdate_4.0.3_linux_amd64.deb
dpkg -i /tmp/geoipupdate_4.0.3_linux_amd64.deb
mv /etc/GeoIP.conf{,.bak}
cat << EOF | sudo tee -a /etc/GeoIP.conf
AccountID 0
LicenseKey 000000000000
EditionIDs GeoLite2-Country GeoLite2-City GeoLite2-ASN
DatabaseDirectory /data/matomo/maxmind
EOF

## 下载最新maxmind数据库
geoipupdate
ls -lah /data/matomo/maxmind/
总用量 67M
drwxr-xr-x 2 root root 4.0K 7月   7 17:25 .
drwxr-xr-x 6 root root 4.0K 7月   7 17:23 ..
-rw------- 1 root root    0 7月   7 17:25 .geoipupdate.lock
-rw-r--r-- 1 root root 6.3M 7月   7 17:25 GeoLite2-ASN.mmdb
-rw-r--r-- 1 root root  57M 7月   7 17:25 GeoLite2-City.mmdb
-rw-r--r-- 1 root root 3.7M 7月   7 17:25 GeoLite2-Country.mmdb

## 定时更新ip数据库
cat << EOF | sudo tee -a /etc/cron.d/geoipupdate
50 2 * * 4 root /usr/bin/geoipupdate
EOF

## 设置php.ini
cat << EOF | sudo tee -a /data/matomo/php/php.ini
upload_max_filesize = 128M
post_max_size = 128M
max_execution_time = 200
memory_limit = 256M
EOF

docker-compose.yaml

version: "2"
services:
  matomo:
    image: matomo:latest
    stdin_open: true
    volumes:
      - /data/matomo/config:/var/www/html/config
      - /data/matomo/logs:/var/www/html/logs
      - /data/matomo/php/php.ini:/usr/local/etc/php/php.ini
      - /data/matomo/maxmind/GeoLite2-City.mmdb:/var/www/html/misc/GeoLite2-City.mmdb
      - /data/matomo/maxmind/GeoLite2-Country.mmdb:/var/www/html/misc/GeoLite2-Country.mmdb
      - /data/matomo/maxmind/GeoLite2-ASN.mmdb:/var/www/html/misc/GeoLite2-ASN.mmdb
    tty: true
    ports:
      - 80:80/tcp
      - 443:443/tcp

rancher-compose.yaml

version: "2"
services:
  matomo:
    scale: 1
    start_on_create: true
    health_check:
      response_timeout: 2000
      healthy_threshold: 2
      port: 80
      unhealthy_threshold: 3
      initializing_timeout: 60000
      interval: 2000
      strategy: recreate
      reinitializing_timeout: 60000

image.png

配置 matomo

选择中文
image.png
系统检查
image.png
配置数据库
image.png
自动建表完成
image.png
创建管理员用户(忘记截图了)
设置分析网站(可以随便创建，后边再进行修改),注意跟进实际情况修改时区
image.png
复制跟踪代码
image.png
配置 matomo
image.png
登陆
image.png

Sentry

rancher 创建 Sentry

docker-compose.yml

version: "2"
services:
  cron:
    image: sentry:9
    environment:
      SENTRY_MEMCACHED_HOST: memcached
      SENTRY_REDIS_HOST: redis
      SENTRY_POSTGRES_HOST: postgres
      SENTRY_EMAIL_HOST: smtp
      SENTRY_SECRET_KEY: SENTRY_SECRET_KEY_XXX
    stdin_open: true
    volumes:
      - /data/sentry-data:/var/lib/sentry/files
      - /data/sentry-data/config.yml:/etc/sentry/config.yml
    tty: true
    command:
      - run
      - cron
  memcached:
    image: memcached:1.5-alpine
  web:
    image: sentry:9
    environment:
      SENTRY_MEMCACHED_HOST: memcached
      SENTRY_REDIS_HOST: redis
      SENTRY_POSTGRES_HOST: postgres
      SENTRY_EMAIL_HOST: smtp
      SENTRY_SECRET_KEY: SENTRY_SECRET_KEY_XXX
    stdin_open: true
    volumes:
      - /data/sentry-data:/var/lib/sentry/files
      - /data/sentry-data/config.yml:/etc/sentry/config.yml
    tty: true
    ports:
      - 9000:9000/tcp
  worker:
    image: sentry:9
    environment:
      SENTRY_MEMCACHED_HOST: memcached
      SENTRY_REDIS_HOST: redis
      SENTRY_POSTGRES_HOST: postgres
      SENTRY_EMAIL_HOST: smtp
      SENTRY_SECRET_KEY: SENTRY_SECRET_KEY_XXX
    stdin_open: true
    volumes:
      - /data/sentry-data:/var/lib/sentry/files
      - /data/sentry-data/config.yml:/etc/sentry/config.yml
    tty: true
    command:
      - run
      - worker
  redis:
    image: redis:3.2-alpine
  postgres:
    restart: unless-stopped
    image: postgres:9.5
    volumes:
      - /data/postgresql/data:/var/lib/postgresql/data
    ports:
      - 5432:5432/tcp

注意把 SENTRY_SECRET_KEY 换成 sentry 的实际 secret key

rancher-compose.yml

version: "2"
services:
  cron:
    scale: 1
    start_on_create: true
  memcached:
    scale: 1
    start_on_create: true
  web:
    scale: 1
    start_on_create: true
    health_check:
      response_timeout: 2000
      healthy_threshold: 2
      port: 9000
      unhealthy_threshold: 3
      initializing_timeout: 60000
      interval: 2000
      strategy: recreate
      reinitializing_timeout: 60000
  worker:
    scale: 1
    start_on_create: true
  redis:
    scale: 1
    start_on_create: true
  postgres:
    scale: 1
    start_on_create: true
    health_check:
      response_timeout: 2000
      healthy_threshold: 2
      port: 5432
      unhealthy_threshold: 3
      initializing_timeout: 60000
      interval: 2000
      strategy: recreate
      reinitializing_timeout: 60000

先将 docker-compose.yml 保存到服务器上，用来初始化 db 和创建账号

docker-compose run --rm web upgrade
Would you like to create a user account now? [Y/n]: y
Email: anjia0532@gmail.com
Password:
Repeat for confirmation:
Should this user be a superuser? [y/N]: y
## 直到输出
Migrated:
 - sentry
 - sentry.nodestore
 - sentry.search
 - social_auth
 - sentry.tagstore
 - sentry_plugins.hipchat_ac
 - sentry_plugins.jira_ac
Creating missing DSNs
Correcting Group.num_comments counter
## 并退出

配置 Sentry

image.png
image.png
image.png
image.png
image.png
image.png
image.png

配置 vue

本文以 iview-admin 为例

git clone https://gitee.com/anjia/iview-admin.git
cd iview-admin

sentry

注意，网上很多文档，以讹传讹的使用过时的工具，raven-js .从 5.x 后官方建议使用@sentry/browser 和@sentry/integrations

npm install --save @sentry/integrations
npm install --save @sentry/browser

修改 iview-admin\src\main.js

// The Vue build version to load with the `import` command
// (runtime-only or standalone) has been set in webpack.base.conf with an alias.
import Vue from "vue";
import App from "./App";
import router from "./router";
import store from "./store";
import iView from "iview";
import i18n from "@/locale";
import config from "@/config";
import importDirective from "@/directive";
import { directive as clickOutside } from "v-click-outside-x";
import installPlugin from "@/plugin";
import "./index.less";
import "@/assets/icons/iconfont.css";
import TreeTable from "tree-table-vue";
import VOrgTree from "v-org-tree";
import "v-org-tree/dist/v-org-tree.css";
import * as Sentry from "@sentry/browser";
import * as Integrations from "@sentry/integrations";
// 实际打包时应该不引入mock
/* eslint-disable */
if (process.env.NODE_ENV !== "production") require("@/mock");

Vue.use(iView, {
  i18n: (key, value) => i18n.t(key, value),
});
Vue.use(TreeTable);
Vue.use(VOrgTree);
/**
 * @description 注册admin内置插件
 */
installPlugin(Vue);
/**
 * @description 生产环境关掉提示
 */
Vue.config.productionTip = false;
/**
 * @description 全局注册应用配置
 */
Vue.prototype.$config = config;
/**
 * 注册指令
 */
importDirective(Vue);
Vue.directive("clickOutside", clickOutside);

/* eslint-disable no-new */
new Vue({
  el: "#app",
  router,
  i18n,
  store,
  render: (h) => h(App),
});

Sentry.init({
  dsn: "https://xxx@xxx.xxx.com/xxx",
  integrations: [
    new Integrations.Vue({
      Vue,
      attachProps: true,
    }),
  ],
});
npm install
npm run dev

打开 http://localhost:8080/error_store/error_store_page
分别点击两个按钮，模拟出错
image.png
打开 sentry 发现已经有错误上报了，并且对错误进行聚合。
image.png
image.png点开查看详细内容。

如果需要生成 source-map ,可以参考官方文档 https://docs.sentry.io/platforms/javascript/sourcemaps/

matomo

image.png
image.png
image.png

npm install --save vue-matomo

修改 iview-admin\src\main.js

// The Vue build version to load with the `import` command
// (runtime-only or standalone) has been set in webpack.base.conf with an alias.
import Vue from "vue";
import App from "./App";
import router from "./router";
import store from "./store";
import iView from "iview";
import i18n from "@/locale";
import config from "@/config";
import importDirective from "@/directive";
import { directive as clickOutside } from "v-click-outside-x";
import installPlugin from "@/plugin";
import "./index.less";
import "@/assets/icons/iconfont.css";
import TreeTable from "tree-table-vue";
import VOrgTree from "v-org-tree";
import "v-org-tree/dist/v-org-tree.css";
import * as Sentry from "@sentry/browser";
import * as Integrations from "@sentry/integrations";
import VueMatomo from "vue-matomo";

// 实际打包时应该不引入mock
/* eslint-disable */
if (process.env.NODE_ENV !== "production") require("@/mock");

Vue.use(iView, {
  i18n: (key, value) => i18n.t(key, value),
});
Vue.use(TreeTable);
Vue.use(VOrgTree);
/**
 * @description 注册admin内置插件
 */
installPlugin(Vue);
/**
 * @description 生产环境关掉提示
 */
Vue.config.productionTip = false;
/**
 * @description 全局注册应用配置
 */
Vue.prototype.$config = config;
/**
 * 注册指令
 */
importDirective(Vue);
Vue.directive("clickOutside", clickOutside);

/* eslint-disable no-new */
new Vue({
  el: "#app",
  router,
  i18n,
  store,
  render: (h) => h(App),
});

Sentry.init({
  dsn: "https://xxx@xxx.xxx.com/xxx",
  integrations: [
    new Integrations.Vue({
      Vue,
      attachProps: true,
    }),
  ],
});
Vue.use(VueMatomo, {
  // Configure your matomo server and site by providing
  host: "//xxxx.xxxx.com/",
  siteId: xx,

  // Changes the default .js and .php endpoint's filename
  // Default: 'piwik'
  trackerFileName: "matomo.js",

  // Overrides the autogenerated tracker endpoint entirely
  // Default: undefined
  trackerUrl: "//xxxx.xxxx.com/matomo.php",

  // Enables automatically registering pageviews on the router
  router: router,

  // Enables link tracking on regular links. Note that this won't
  // work for routing links (ie. internal Vue router links)
  // Default: true
  enableLinkTracking: true,

  // Require consent before sending tracking information to matomo
  // Default: false
  requireConsent: false,

  // Whether to track the initial page view
  // Default: true
  trackInitialView: true,

  // Whether or not to log debug information
  // Default: false
  debug: false,
});

// or
window._paq.push;

// or through
window.Piwik.getTracker;

打开 http://localhost:8080, 随便访问几个菜单,然后打开 matomo
image.png
image.png
路由已经有数据了
image.png
并且将用户的常规数据聚合起来

更多

其实本文只是 sentry 和 matomo 简单介绍
更深入的使用，比如 sentry，推送邮件，文中一带而过的 sourcemap，单点登录(集成内部的权限认证)，自定义上报内容(将错误与用户 id 关联起来)，,敏感数据脱敏等
比如 matomo, 每日发送分析报表，增加 kafka 插件，进行更深层次的挖掘，自定义上报内容(购物车等),大数据量情况下的优化，优化用户设备指纹，使用了 nginx 等反代软件后，如何正确识别真实 ip，热力图，A/B test,漏斗图等

来源：https://anjia0532.github.io/2019/07/07/sentry-and-matomo-install/

评论

发表评论

此博客中的热门博文

近期折腾 tailscale 的一些心得

发布于
一、我的需求 最近自己装了一台高配台式机，打算当作自己的主力机器使用，笔记本电脑就作为一个移动 UI，工作都远程连到家里台式机使用。 为了满足这个需求，就需要 NAT 穿透，正好最近 mesh vpn 的概念很火，又看到 tailscale 正好对个人用户免费，于是就想试试看了。 二、TailScale 是什么 VPN 是什么？ 虽然国人看到 VPN 第一反应应该是“翻墙”，但 VPN 最初应该也是最普遍的用途应该是用来做内网打通， 这也是其名字虚拟私有网络的用意，VPN 让你可以在公开的网络线路上建立一个私有的子网， 然后将所有接入的机器都分配一个私有的内网地址，让他们可以通过 VPN 的私有网络互联。 比如最常见的需求就是，公司有一个内网办公环境，当你外出办公时，也希望你的电脑能够接入办公网络。 因为外网的机器和内网的机器不能互联，所以一般会有一个中心服务器， 所有的子节点都和中心服务器相连，然后中心服务器转发所有的流量。 这样做的缺点显而易见，首先是中心服务器（hub）会成为瓶颈。 其次，某种极端情况下，如果节点 A 和 节点 B 距离非常近，但是都离 hub 很远， 这样就会导致非常高的延迟。 那么我们就会想，能不能让节点间直接互联呢？ 这就是 mesh VPN，其实现就是 wireguard。 wireguard 的每一个节点都会存储其他所有节点的信息，并且和其他所有的节点都建立 tls 连接。 如果涉及到内网穿透的话，那么你需要找到一台处于网关位置的节点（内外网都可达），将其设置为 coordinator， 扮演类似于 hub 的角色， 分发穿透内外网的流量。 wireguard 的缺点在于： 配置比较繁琐 维护也比较困难，增删节点都需要改动所有节点的配置 基于上述这些痛点，tailscale 做了一些改进： 在原有的 ICE、STUN 等 UDP 协议外，实现了 DERP TCP 协议来实现 NAT 穿透 基于公网的 coordinator 服务器下发 ACL 和配置，实现节点动态更新 通过第三方（如 Google） SSO 服务生成用户和私钥，实现身份认证 简而言之，我们可以认为 tailscale 是更为易用版的、功能封装更为完善的 wireguard。 三、TailScale 能做到什么 只要你的机器可以连到公网，tailscale 可以让所有的...
阅读全文

Mifare Classic card(M1)卡破解过程

发布于
一次偶然原因，在网上看到关于一些Mifare Classic card卡的破解文章,发现成本不是很高,并且门槛也不太高（本人笨得很,没觉得低）觉得很有意思，准备入坑一波。正好我寝室有饭卡、洗澡卡和直饮卡,爲啥不试一试呢,嘿嘿.说干就干! 于是乎就在网上各种收集资料,(本人懒得很,不想去图书馆查资料)首先我们得搞懂M1卡的内部结构是吧，不然无从下手啊,所以我们先从结构说起吧. 可能文章有点长，着急的话可以直接跳过前面三个点 1.M1卡的存储内部结构： M1卡分爲16个扇区，每个扇区对应4块（块0-块3）,共64块，编号爲0-63.第0扇区的第0块用于存放厂商代码，已经固化无法更改。其馀区的第0-2块用于存放数据，块3爲控制块用于存放密码A、存取控制、密码B，结构如下：      A0 A1 A2 A3 A4 A5     FF 07 80 69    B0 B1 B2 B3 B4 B5      (密码A 6字节)     (存储控制 4字节)    (密码B 6字节) 并且每个扇区块3中的密码和存储控制全部都是独立的，独立控制本扇区的各种操作，每个扇区都能实现不同的功能，所以广泛用作一卡通。存储控制里面4字节的具体含义我也不是很清楚(不影响我们破解)，所以就不说出来误导大家了。 卡中每个块包含16字节，所以M1卡的容量=16扇区*4块*16字节=1024字节=1k  (M1卡的由来)。 知道了M1卡的大致结构我们就可以开始进行破解了，我在此收集了几种常见的破解手段。 2.M1卡的破解原理：   1）暴力破解： 暴力破解是最简单粗暴、不需要多少技术含量的，就是比较费时，但这并不妨碍大家对它喜爱之情。因爲M1是被动卡，需要读卡器爲之供能，一旦读卡器切断电源，卡中临时数据就会丢失，所以无论试错多少次密码都不会被锁定。特别是一些厂商偷懒用弱密码，花不了多少时间就能破解。 2）克隆卡片： 这算是最简单又实用的方法了。因爲M1卡加密扇区里面保存着各种数据，所以可以克隆一张带有同样数据的克隆卡。这就会用到一种叫UID卡的特殊M1模拟卡。前面说过，每张卡在0...
阅读全文

买二手车选择哪个网络平台好

发布于
从购车需要专业技能程度来排行（从高到低），（汽车拍卖平台）车置宝=车速拍=优信拍>（二手车信息平台）58同城=二手车之家=赶集=咸鱼>（超级中间商）瓜子二手车=人人车=优信全国购 像汽车拍卖平台基本上都算是车商的批发平台 上面的车鱼龙混杂，什么车都有 大部分都是市场里买不出积压很久的库存车辆 只有很少一部分是个人的车源 也有很多事故车在上面流通 至于上面的评估报告 简单看一下就好 准确率一般般 评估师评估的很一般 而且很难实地看车 这种平台唯一的优势就是价格比其他平台低一些 记住是低一些！不是低于市场价！ 上面有很多车商在和你共同竞价 价格一般都会控制在车商收购价左右 假如一辆市场零售价10w的车，市场收车价8.5w 在拍卖平台上成交价可能在8.2w-9.2w这个区间 至于这个价格怎么把控 就要看这辆车的车况 车况不错，你出9.2w拿下来都划算 车况不好，8w拿回家都亏 还有一点就是 拍卖平台上的车源流动性很大 基本上每天都有成百上千辆车不停的流通 要想挑到符合自己需求的车，需要每天都上去望一眼 如果身边有懂二手车的朋友可以去上面捡捡便宜车 要是没有！请忘记我说的这个平台 买到有问题的车 平台可不会给你有任何赔偿 专业难度：?????（极高） 购车风险：?????（极高） 车辆车况：??（低） 车辆价格：????（低） 购车时长：??（长） 推荐指数：??（不太推荐） 注：需要专业知识，二手车评估，二手车估价，二手车购车流程 接下来我们说一说二手车信息平台58同城、二手车之家、赶集、咸鱼等 这种平台类属于我们小区门口的公示栏 他提供一个广告位 车商陆陆续续的在上面发自己的车源小广告 平台赚取的是车商发布车源的推广费用 上面车源质量会比拍卖平台上的车源好一些 至少你按照正常市场价购买的车辆 碰到事故车的可能性会小很多 车源也很丰富 不用每天都上去看有没有喜欢的车， 发布车源的车商基本上都有实体店 可以带评估师上门看实车车况 过户手续可以让车商解决 相对拍卖平台风险会小很多 购车时间也很短 钱到位了直接开走约过户就可以了 出问题闹事也方便（手动狗头） 价格基本都可以砍 按照正常行情价砍车商也不会介意什么的 现在车商基本上有点利润空间就卖 但是你要拿个传奇屠龙刀去杀价 10w零售价的车对半砍5w 车商也会默默的帮你把杯中的茶加满 面带微笑的告诉你出门左转有家医...
阅读全文

如何防止Cloudflare CDN背后的图片被盗连(Hotlink Protection)？

发布于
「Hotlink Protection」(直接链接保护)是经营网站经常需要去注意的一块，但为什么我们会需要「Hotlink Protection」呢？身为图文并茂的网络文章作家，最担心得就是自己的文章被别人整篇连文带图地拷贝粘贴到其它地方了。此时如果图片有套用「Hotlink Protection」的话，就可以让被盗用的图片在其它网站上「不被正常显示」出来，如此一来，就能使其它误入盗文页面的访客可以知道该篇文章是篇被盗用的文章。不同的网站架构有不同的「Hotlink Protection」的设置方式，如果您的网站有打开Cloudflare的CDN服务的话，可以参考这篇文章，来实现「Hotlink Protection」的功能。 我的网站服务器是用Nginx或Apache，难道不能直接对它们做设置吗？ 很遗憾，只要我们有激活Cloudflare的CDN服务，就无法有效地通过自己的服务器程序来设置Hotlink Protection。这是因为网页浏览器在打开您网站的图片时，会去链接Cloudflare的CDN服务器，而非我们自己的服务器，所以就算我们有在自己的服务器上制作Hotlink Protection的功能，也根本不会被触发到。 既然有Cloudflare CDN，为什么还要Hotlink Protection？被盗连的图，其流量不是不会算在我们头上吗？ 的确，有了Cloudflare CDN之后，就算图片被盗连，它主要也还是会去吃Cloudflare CDN服务器的流量。但是，您真的愿意让您文章中的图片原封不动地在盗文网站上显示出来吗？所以还是设置一下Hotlink Protection吧！ Cloudflare内置的Hotlink Protection开关 Cloudflare的控制后台中，其实就有提供一个一键套用Hotlink Protection的开关，只要打开来，就可以让有激活CDN功能的网域拥有Hotlink Protection的功能。这个开关藏在Cloudflare控制后台的「Scrape Shield」分页中。 这个Hotlink Protection一旦打开，整个有打开Cloudflare CDN服务的网域(包含子网域)下的图片链接，就只能在这整个网域(包含子网域)下打开，否则的话会直接回传HTTP的403...
阅读全文

Swagger 生成 PHP restful API 接口文档

发布于
需求: 为客户端同事写接口文档的各位后端同学,已经在各种场合回忆了使用自动化文档工具前手写文档的血泪史. 我的故事却又不同,因为首先来说,我在公司是 Android 组负责人,属于上述血泪史中催死人不偿命的客户端阵营. 但血泪史却是相通的,没有自动化文档的日子,对接口就是开发流程中最低效的环节. 因此决定使用 swagger 搭建由php注释生成文档的流程. 背景: 我们的 restful api 项目采用 phalcon 框架,整体结构很简单,我们只需要用 swagger 扫描 controller 目录即可. 下简称我们的 php api 项目为 php_api_project. 服务器采用 nginx. 搭建: 先说下最终的文档生成流程会是什么样子,以便先有个整体的认识: 搭建完成后, 整个流程, 从文档生成到前端展现, 大体如下: 在php文件中写 swagger 格式的 /** 注释 */ 用 swagger-php 内的 bin/swagger.phar 命令扫描 php controller 所在目录, 生成 swagger.json 文件 将 swagger.json 文件拷贝到 swagger-ui 中 index.html 指定的目录中 打开 swagger-ui 所在的 url, 就可以看到文档了. 文档中的各个 api 可以在该网址上直接访问得到数据. 实现此需求只需要 swagger 的如下两个项目: swagger-php: 扫描 php 注释的工具. 内含一个不错的例子. swagger-ui: 用以将扫描工具生成的 swagger.json 文件内容展示在网页上. 首先将这两个项目下载到本地: $ git clone https : //github.com/swagger-api/swagger-ui.git $ git clone https : //github.com/zircote/swagger-php.git 文档生成工具部署: 说是部署,主要就是产生 bin/swagger 这个用来生成 swagger.json 文件的命令. 主要工作,就是用 composer 解决下依赖就可以了. 因为国内直接用 composer 比较蛋疼,所以最好设置下国内的那个 c...
阅读全文

Docker php安装扩展步骤详解

发布于
前言 此篇，主要是演示docker-php-source , docker-php-ext-install ,docker-php-enable-docker-configure 这四个命令到底是用来干嘛的，它们在PHP容器中都做了哪些事情。 很多人很不理解在Dockerfile中安装PHP扩展的时候总是出现这几个命令，本篇就就是为你揭开这些命令的神秘面纱而准备的，所有案例都是本人自己运行过的。 Docker 中的PHP容器安装扩展的方式有 通过pecl方式安装 通过php 容器中自带的几个特殊命令来安装，这些特殊命令可以在Dockerfile中的RUN命令中进行使用。 这里，我们主要讨论的是第二种方案，如何通过PHP容器中的几个特殊命令来安装PHP扩展 PHP中安装扩展有几个特殊的命令 docker-php-source docker-php-ext-install docker-php-ext-enable docker-php-ext-configure 演示这三个命令的作用 都是在PHP容器中进行演示的，PHP容器启动太简单，不作过多介绍 docker-php-source 此命令，实际上就是在PHP容器中创建一个/usr/src/php的目录，里面放了一些自带的文件而已。我们就把它当作一个从互联网中下载下来的PHP扩展源码的存放目录即可。事实上，所有PHP扩展源码扩展存放的路径： /usr/src/php/ext 里面。 格式 ： docker-php-source extract | delete 参数说明 ： * extract : 创建并初始化 /usr/src/php目录 * delete : 删除 /usr/src/php目录 案例 ： root@803cbcf702a4 :/usr/src # ls -l total 11896 #此时，并没有php目录 -rw-r--r-- 1 root root 12176404 Jun 28 03 : 23 php.tar.xz -rw-r--r-- 1 root root 801 Jun 28 03 : 23 php.tar.xz.asc root@803cbcf702a4 :/usr/src # docker-php-sour...
阅读全文

小成本启动跨境电商教程

发布于
现在开始写小成本启动跨境电商教程的第一篇 先再多说点废话  第一,这个教程是给小白,菜鸟看的,合适观看人群是那种学生团体,国企上班员工,或者公司技术或者程序员,或者有空余时间的自由职业者,其他也有点小钱,想在网上搞点小生意做的人群看的起步教程,不可能是那种商业教科书,也不是煽动别人一个月成为千万富翁,或者让你分分钟成为有钱人. 那是不可能的,这个教程就是让你 小成本启动一个外贸项目,然后告诉你里面所要处理的坑 而且因为是小成本和公司和大公司的运作不一样.请不要用公司的眼光来看待. 第二,对于那么说废话,或者说话阴阳怪气的,我只想说, 我一直没有接受过**的思想 ,就是我很能接受别人的反对意见,没有人反对是很苍白的,而且我一直都认为,这世界是不是被美好的情感和行为推动的,相反,这世界的进步一直都是被人性的黑暗和欲望推动的, 这世界上的人有大方的,豁达的,也有狭隘的,自私的, ------所以,我理解别人的质疑或者恶意的诋毁.我反而认为这些人会有成就. 甚至长久以来的生活经历让我一直迷惘,或许,自私和虚伪的人才更能在这社会出头,当然还有很多我就不再这里展开阐述.和本教程无关. 但是没有大方的人无偿的分享和教授别人,互联网是不可能发展起来的,有很多的例子,比如Linux 等等,我也不这里叙说. 本案例重点就是帮助那些中小城市,有时间,有点小钱,亏了也无所谓,特别是远离货源地,但是又想做网上生意,但是让大家离开自己生活的城市,或者放弃自己的工作,去货源地组一个公司或者团队,大家估计很难接受.也很不现实,那么,我这个教程其实就是教你怎么样不用在进入这些坑.帮你解决这些问题. 结束废话,进入正文, 独立跨境电商建站的好处 如果你是像我说的那类人 一,学生,有大把的时间,但是没有太多钱,有无穷无尽的精力,对一切都是那样的好奇,又想做中国梦,------OK.看下去 二,国企员工,早就把人生和社会看透,有闲的发慌的时间,也有一定的余钱,亏了也无所谓,但是不是很懂技术,而且住家远离货源地,给你吹牛,精神胜利法,让你辞职,让你去混大上海,广州,北京,你一脸煞笔看着我.-------OK.看下去 三,公司技术员,本论坛主要是程序员.这些人,有技术,有能力,但是没有时间,整天累的吐血,手头有一笔钱,但是也远离货源地------O...
阅读全文

订单系统设计的思考（分层篇与状态一致篇）

发布于
出于系统分层的目的，售卖系统中订单可以设计成业务层订单和支付层订单，前者关注业务行为，后者更关注资金变更，二者通过唯一ID关联。 不分层的订单系统 前提 以下讨论的订单系统基于LNMP实现。 对于描述错误的地方，烦请告知。 订单的基本组成 说起订单，个人认为至少应该包含如下元素： 商品信息 购买者信息 支付信息 支付状态 订单状态 商品信息 指的是诸如商品的编号，名称这类商品的基础信息。 购买者信息 是购买者的物流信息，用户身份信息等数据。 支付信息 是支付金额，支付方式等数据。 支付状态 是订单支付相关行为的操作依据。 订单状态 是订单在业务系统中，对其他使用者给出的带有业务特征的操作依据。 不做分层的实现 最简单的一种方式，就是一条表记录，记录上述所有信息。 接触过的某网店框架的订单部分，订单的所有信息，甚至物流信息都记录在一张表中，好处当然是有的，就是操作起来相当方便，只要一次查询，就能拿出订单相关的所有信息。对于数据报表之类的需求来说，这样的订单表设计大大降低了数据获取部分的开发难度。 在业务系统规模较小时，这并不成为任何问题，因为一切运行正常，不需要过度设计。 一旦业务规模增大，需要使用这一系统的业务方增多，对接的外部服务越来越复杂，这个系统还能正常运转吗？ 想象一下当需要修改新增订单的一个状态，然而其他需求的开发人员提到这个状态添加之后会给他们的功能带来流程上的影响；或者是需要通过多个字段才能确定出一个订单的实际状态，相信会想问当初设计时为什么杂糅了这么多的数据。 可能会引发的现象： 表字段过多，难以添加有效索引 新增业务行为需要新增字段，增加表字段数量 对接上游支付的行为需要业务开发人员关注（耦合了实际支付操作） 逻辑单元越来越臃肿，开发上难以细致的拆分工作 错误的操作引起不正确的支付行为 分层方案 分层目标 之前提到说不分层在业务规模发展到一定程度后会给后续功能开发带来不便，分层的目标就是解决这些问题。 归结起来，核心的问题就是如何能提高业务的 可扩展性 、 开发效率 和 安全性 。 设计方案 可以在订单系统内部实现两层。 一层在本文中称为 业务层 ，关注的是业务行为，比如订单的商品个数，收件人，地址，电话等数据。 另一层在本文中会称作 支付层 ，关注的是...
阅读全文

斐讯 N1 部署 Docker 和 OpenWRT，并利用 Hostapd 开启 Wi-Fi 热点

发布于
刷入 Armbian 的 N1 可以通过安装 Docker 做很多事情，部署 OpenWRT 路由系统就是其中之一，同时利用 Hostapd 更可以开启 Wi-Fi 热点，方便作为一台便携路由使用。 该方案使用场景：在任意网络末端，N1 通过有线连接接入上级路由（DHCP或PPPoE），允许其他无线设备接入其 Wi-Fi 分享网络。 本方案在 armbian_5.77_aml-s905_Ubuntu_bionic_default_5.0.2_20190401.img.xz_ 和 Openwrt 18.06.2 官方固件下测试通过。 关于 N1 刷入 Armbian 并且安装 Docker 的步骤在此不再赘述，有需求的请先自行搜索完成安装。 基本设定 Wi-Fi热点IP和网关地址 AP IP: 10.168.10.1, gateway: 10.168.10.10 Docker Container IP和网关地址，该处192.168.10.0可按照实际情况修改 container IP: 10.168.10.10, gateway: DHCP from upstream network 192.168.10.0/24 ARMBIAN 设置方案一 首先，完成相应的软件安装 apt-get update apt-get install hostapd docker import https://downloads.openwrt.org/releases/18.06.2/targets/armvirt/64/openwrt-18.06.2-armvirt-64-default-rootfs.tar.gz openwrt:18.06.2 然后，修改相关的网络设置文件 修改“network/interfaces” vi /etc/network/interfaces #运行指令，以下为文件内容 ... iface eth0 inet dhcp ... iface wlan0 inet manual ... 修改“interfaces.d/bridge” vi /etc/network/interfaces.d/bridge #运行指令，以下为文件内容 auto br-lan ...
阅读全文

N1小钢炮安装Zerotier 实现远程访问

发布于
2020年，开年战疫情，假期延长，闲来无事瞎折腾。 N1挖矿已死，闲置已久，本人小白一枚，奈何善于学习，最近趴在网上研究大神们的各种教程。 从刷小钢炮到最终解决了N1小钢炮的远程访问问题，步履维艰，折腾了好几天。 Zerotier是什么就不解释了，小白也解释不清楚，各位自行度娘。 小白只知道N1可以利用Zerotier来实现远程访问，今天要写的也是尽量让小白能看懂的内容。 一、N1安装Zerotier准备工作 1、硬件：一台已经成功刷机的小钢炮 可以参考张大妈上“法行天下”的教程，比较详细，适合小白，但实际操作过程中也有需要注意的一些问题，后续再写。 2、软件：Mobaxterm工具，Putty工具也可以，自行度娘下载，下面是以Mobaxterm演示，安装后如下。 3、小钢炮插电开机，插上 网线 ，连上 路由器 ，与电脑保持在同一局域网下，当然小钢炮已经按照“法行天下”的教程完成了大部分的设置。 二、小白级操作——安装Z erotier 操作分两个步骤进行，安装entwarey以及zerotier。 主要参考了张大妈“”上“ Ttiramisu ”发布的“N1小钢炮安装zerotier 进行内网穿透”一文，这篇文章写得过于简单，全是代码，初看完全摸不着头脑。 先安装entware，具体操作：启动Mobaxterm，点击“Session”创建会话，选择SSH，输入N1的IP地址（打开路由器后台自行查看即可），其他不用设置，如下图： 进入到对话框，输入N1账户名，一般是“root”，然后回车，会要求输入密码，N1小钢炮的登陆密码，不是其他，注意，此时输入密码是不显示的，不要觉得奇怪，果断输入完后直接回车就可以连接上N1，如下图。 然后可以利用张大妈上“ Ttiramisu ”发布的“N1小钢炮安装zerotier 进行内网穿透”一文中的命令先安装entware，再安装zerotier。 安装entware命令，先后输入： 1、rm -rf /opt； 2、mkdir /opt； 3、cd /opt； 4、wget -O - http://bin.entware.net/aarch64-k3.10/installer/alternative.sh | sh 以上，一步一步输入命令回车即可。 注意这一步：将自带opkg改名为opkg_bak暂时停用 灯大固件更新可以改回来免...
阅读全文