Ernest的Blog

使用Github Actions 完成编译、发布release apk

Mon, 25 Apr 2022 09:30:55 GMT

使用Github Actions，我们可以编译，运行测试，还可以签署发布工件 。但是，如果我们将密钥库上载到公共存储库，这很危险。作为开发人员，我们必须采取一些预防措施，例如不要提交API密钥或密钥库（使用Github Actions作为CI并不是这样做的借口。）

那我们怎样才能在仓库中使用github actions 完成编译签署发布工作，同时又保证密钥和密钥口令的安全性呢？

跟着以下步骤，你应该就能明白了。

创建签名环境#

创建签名环境，主要实现两个目标，一是保护签名文件不被泄露，公共存储库是所有人可读的。二是保证签名文件的密钥密码等信息不被泄露，包括在执行编译、发布apk整个过程的安全。

创建存储签名文件的私有仓库#

首先，我们在github上创建一个私有仓库，为简单起见，我们将其称为 keystore。得到的仓库地址是git@github.com:Ernest-su/keystore.git

然后，把仓库clone到本地。git clone git@github.com:Ernest-su/keystore.git

将签名文件放到keystore内.例如，我的签名文件名称是keyfile

1
git add .\keyfile
2
git commit -m "添加签名文件"
3
git push origin main

注意: 在github上新建仓库的时候，github已经把默认分支从以前的master改为了main ,所以上面的命令是git push origin main，而不是之前的git push origin master

添加签名文件仓库为git的子模块#

切换到项目目录，使用以下命令将包含密钥文件的私有存储库添加为子模块，为简单起见，我们将其称为 keystore。

git submodule add git@github.com:Ernest-su/keystore.git keystore

这样，我们便拥有了可以在本地进行签名的密钥库，并且因为该仓库是私有仓库，其他人不会获取到签名文件。

image-20220426130338684

可以看到，项目已经多了一个keystore文件夹，里面有我们的签名文件。因为是作为git的子模块submodule 来添加的，所以提交的时候，项目只会引用子模块的提交信息，不会包含此文件夹。

image-20220426130224297

加密的环境变量 Secrets#

为了拥有更安全的环境来使用github actions签署apk,我们在项目的设置中做以下配置。

在项目 Settings -> Secrets-> Actions 中配置加密的环境变量，这里配置的环境变量很安全，有特殊处理，不会在日志中显示。同时也不会传递由 Fork 发起的 Pull Request。

以下配置，KEY*开头的是签名文件的密码和签名别名，根据上面添加为git子模块的签名文件填入正确的信息。

TOKEN配置的是github 的 PAT,也就是Personal access tokens，这里就不展开介绍了，可以查阅官方的说明这里配置的TOKEN用于Github Actions执行时，拉取私有仓库子模块的签名文件。

image-20220426130619781

修改app签名配置#

在app模块的build.gradle中调整签名配置。System.getenv读取的是系统环境变量，在GitHub Actions执行时候，读取的是上面加密的环境变量 Secrets 中配置的信息。

1
    signingConfigs {
2
        release {
3

4
            storeFile file(KEYSTORE)
5

6
            storePassword System.getenv("KEYSTORE_PASSWORD")
7

8
            keyAlias System.getenv("KEY_ALIAS")
9

10
            keyPassword System.getenv("KEY_PASSWORD")
11
        }
12
    }

在项目根目录的gradle.properties配置以下信息。我们把KEYSTORE直接在这里定义了，而不是通过获取系统环境变量的方式。当然，通过上面定义加密的环境变量Secrets,再用读取系统环境变量的方式，也是ok的。

1
KEYSTORE=../keystore/keyfile
2
#以下配置到环境变量里了,在github actions的脚本中会自动读取
3
# KEY_ALIAS=System.getenv("KEY_ALIAS")
4
# KEY_PASSWORD=[your key password]
5
# KEYSTORE_PASSWORD=[your store password]

配置Github Actions#

在项目新建.github\workflows目录，在workflows目录下新建android.yml文件,内容如下：

1
name: Android CI
2

3
on:
4
  push:
5
    tags:
6
      - '*'
7

8
jobs:
9
  build:
10

11
    runs-on: ubuntu-latest
12

13
    steps:
14
    - uses: actions/checkout@v3
15
      with:
16
       submodules: recursive
17
       token: ${{ secrets.TOKEN }}
18
    - name: set up JDK 11
19
      uses: actions/setup-java@v3
20
      with:
21
        java-version: '11'
22
        distribution: 'temurin'
23
        cache: gradle
24

25
    - name: Grant execute permission for gradlew
26
      run: chmod +x gradlew
27
    - name: Build with Gradle
28
      env: #  as an environment variable
29
        KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
30
        KEY_ALIAS: ${{ secrets.KEY_ALIAS }}
31
        KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }}
32
      run: ./gradlew assemble
33
    - name: Upload binaries to release
34
      uses: svenstaro/upload-release-action@v2
35
      with:
36
        repo_token: ${{ secrets.GITHUB_TOKEN }}
37
        file:  app/build/outputs/apk/release/*.apk
38
        tag: ${{ github.ref }}
39
        release_name: ${{ github.ref }}
40
        overwrite: true
41
        file_glob: true
42
        body: ""

展开收起

Github Actions 触发条件#

简单说明下配置的含义。

1
on:
2
  push:
3
    tags:
4
      - '*'

意思是在推送tag到远程仓库时候，触发GitHub Actions。'*' 表示推送所有的tag都会触发，可以改为'v*',表示推送了v开头的tag才触发。如果希望是在推送到特定分支时候触发，如release，则可以这样配置

1
on:
2
  push:
3
    branches: [ release ]

或需要推送到master分支时候触发

1
on:
2
  push:
3
    branches: [ master ]

但是需要注意,如果master分支是默认分支，且是私有仓库，会浪费掉GitHub Actions的运行时间额度。公共仓库和自托管运行器免费使用 GitHub Actions。对于私有仓库，每个 GitHub 帐户可获得一定数量的免费记录和存储。关于额度的说明

Github Actions 的子模块配置#

1
- uses: actions/checkout@v3
2
  with:
3
   submodules: recursive
4
   token: ${{ secrets.TOKEN }}

只有加了 submodules: recursive以及 token: ${{ secrets.TOKEN }}才会在构建时候拉取到私有仓库的子模块。

读取Actions 加密系统环境变量#

1
- name: Build with Gradle
2
  env: #  as an environment variable
3
    KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
4
    KEY_ALIAS: ${{ secrets.KEY_ALIAS }}
5
    KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }}

此步骤用于配置解密后的环境变量到系统环境变量中,供gradle脚本使用

上传apk文件到github release#

1
- name: Upload binaries to release
2
  uses: svenstaro/upload-release-action@v2
3
  with:
4
    repo_token: ${{ secrets.GITHUB_TOKEN }}
5
    file:  app/build/outputs/apk/release/*.apk
6
    tag: ${{ github.ref }}
7
    release_name: ${{ github.ref }}
8
    overwrite: true
9
    file_glob: true
10
    body: ""

curl批量下载并设置正确名称

Wed, 05 Jan 2022 06:46:55 GMT

我有一个文件，其中包含一个或多个链接。使用wget从URL列表中下载带有文件名的文件

http://example.com/00001 http://example.com/00002 http://example.com/00003 http://example.com/00004 当在浏览器中手动转到其中一个链接时，文件将自动下载。下载的文件具有该文件的唯一名称，与url路径不同。

我知道使用wget -i file-of-links.txt，但下载时，每个文件的标题将基于url，而不是基于文件名。

是否有一个命令可以让我下载给定文件中的链接并用文件名而不是url名保存下载的文件？

可以使用—trust-server-names和—content-disposition选项执行此操作。

—trust-server-names

如果设置为on，对重定向重定向URL的最后一部分将用作本地文件名。默认情况下，它被用来在原来的URL

—content-disposition

如果设置为on，Content-Disposition的头实验（不完全功能）支持启用的最后一个组件。这可能会导致额外往返服务器的HEAD请求，并且已知会遇到一些错误，这就是为什么默认情况下当前不启用它的原因。

此选项对于某些使用Content-Disposition标头描述下载文件名称的文件下载CGI程序很有用。

Android处理dicom文件记录

Fri, 29 Oct 2021 09:30:55 GMT

dcm4che#

纯java编写，网上有搜到android版本的jar包，是dcm4che低版本，只在安卓平台上实现了reader,没实现writer。github上的版本有reader和writer实现，但是是依赖javax相关包的，安卓上没有这些包。所以用不了github上的版本。

Modules#

dcm4che-audit
dcm4che-audit-keycloak
dcm4che-conf
- dcm4che-conf-api
- dcm4che-conf-api-hl7
- dcm4che-conf-json
- dcm4che-conf-json-schema
- dcm4che-conf-ldap
- dcm4che-conf-ldap-audit
- dcm4che-conf-ldap-hl7
- dcm4che-conf-ldap-imageio
- dcm4che-conf-ldap-schema
dcm4che-core
dcm4che-dcmr
dcm4che-deident
dcm4che-dict
dcm4che-dict-priv
dcm4che-emf
dcm4che-hl7
dcm4che-image
dcm4che-imageio
dcm4che-imageio-opencv
dcm4che-imageio-rle
dcm4che-js-dict
dcm4che-json
dcm4che-mime
dcm4che-net
dcm4che-net-audit
dcm4che-net-hl7
dcm4che-net-imageio
dcm4che-soundex
dcm4che-ws-rs
dcm4che-xdsi
dcm4che-jboss-modules

Utilities#

agfa2dcm: Extract DICOM files from Agfa BLOB file
dcm2dcm: Transcode DICOM file according the specified Transfer Syntax
dcm2jpg: Convert DICOM image to JPEG or other image formats
dcm2json: Convert DICOM file in JSON presentation
dcm2pdf: Extract encapsulated PDF, CDA or STL from DICOM file
dcm2str: Apply Attributes Format Pattern to dicom file or command line parameters.
dcm2xml: Convert DICOM file in XML presentation
dcmdir: Dump, create or update DICOMDIR file
dcmdump: Dump DICOM file in textual form
dcmldap: Insert/remove configuration entries for Network AEs into/from LDAP server
dcmqrscp: Simple DICOM archive
dcmvalidate: Validate DICOM object according a specified Information Object Definition
deidentify: De-identify one or several DICOM files
emf2sf: Convert DICOM Enhanced Multi-frame image to legacy DICOM Single-frame images
findscu: Invoke DICOM C-FIND Query Request
getscu: Invoke DICOM C-GET Retrieve Request
hl72xml: Convert HL7 v2.x message in XML presentation
hl7pdq: Query HL7 v2.x Patient Demographics Supplier
hl7pix: Query HL7 v2.x PIX Manager
hl7rcv: HL7 v2.x Receiver
hl7snd: Send HL7 v2.x message
ianscp: DICOM Instance Availability Notification receiver
ianscu: Send DICOM Instance Availability Notification
jpg2dcm: Convert JPEG images or MPEG videos in DICOM files
json2props: Convert Archive configuration schema JSON files to key/value properties files and vice versa
json2rst: Generate ReStructuredText files from Archive configuration schema JSON files
mkkos: Make DICOM Key Object Selection Document
modality: Simulates DICOM Modality
movescu: Invoke DICOM C-MOVE Retrieve request
mppsscp: DICOM Modality Performed Procedure Step Receiver
mppsscu: Send DICOM Modality Performed Procedure Step
pdf2dcm: Convert PDF file into DICOM file
stgcmtscu: Invoke DICOM Storage Commitment Request
storescp: DICOM Composite Object Receiver
storescu: Send DICOM Composite Objects
stowrs: Send DICOM Composite Objects or Bulkdata file over Web
stowrsd: STOW-RS Server
swappxdata: Swaps bytes of uncompressed pixel data in DICOM files
syslog: Send Syslog messages via TCP/TLS or UDP to a Syslog Receiver
syslogd: Receives RFC 5424 Syslog messages via TCP/TLS or UDP
upsscu: Invokes services of Unified Procedure Step Service Class
wadors: Wado RS Client Simulator
wadows: Wado WS Client Simulator
xml2dcm: Create/Update DICOM file from/with XML presentation
xml2hl7: Create HL7 v2.x message from XML presentation

license: Mozilla Public License Version 1.1

imebra#

Imebra now supplies the pre-compiled library for Android, which applies the Windowing in real time when you use the DicomView class (an Android View that displays the Dicom Image).

There is no need to convert to jpeg: Follow the example in the documentation and then modify the windowing value in the voilut object.

license use Imebra without being bound to the GPLv2 license you have to buy a commercial license. https://imebra.com/buy/

PixelMed #

stackoverflow上有帖子说可以用在安卓上，相关资料很少

DCMTK#

论坛说可以用ndk编译，跑在安卓上

Compiling DCMTK for Android(中文版) https://blog.csdn.net/chenhuakang/article/details/73608510

license free evaluation licence is available for the OFFIS DICOM software packages DCMPPS, DCMPPSCU, PPSMGR, DCMPRINT SCU, DCMPRINT SCP, DCM2AVI, DCMJP2K and DCMSTCOM. The evaluation licence allows to download the software from the internet and to evaluate it for a period of four months. Any further use of the software requires a full licence agreement.

一句话笔记：常用linux命令

Thu, 15 Jul 2021 09:21:02 GMT

文件系统远程挂载#

SMB

//IP地址是windows地址，后面跟上windows上的共享目录，后面的路径是linux上的挂载路径 sudo mount -t cifs //172.20.4.5/临时文件 /data/sync -o username=cad,password=tdc1718,sec=ntlm,vers=1.0

NFS

mount -t nfs -o nolock 172.20.4.106:/home /data/sync

开机挂载

开机自动挂载文件#

修改 /etc/fstab 文件，挂载命令如：

SMB

//192.168.22.111/shared /home/www/ cifs username=xxx,password=xxx,rw,dir_mode=0777,file_mode=0777 0 0

NFS

172.20.4.106:/home /data/sync nfs username=suqishuo,password=suqishuo@4.106,rw,dir_mode=0777,file_mode=0777 0 0

curl,apt 设置代理#

curl -x socks5h://192.168.3.125:9081 -LO http://google.com

sudo apt-get -o Acquire::http::proxy=“socks5h://192.168.3.125:9081/” update apt-get -o Acquire::http::proxy=“socks5h://192.168.3.125:9081/” install xxx

批量替换文件内容#

Terminal window

1
 sed -i 's/http:\/\/tracker\.m.com/https:\/\/tracker\.m\.com/' *.txt

软连接#

sudo ln -s “/data_20t/media/霍元甲港版导演剪辑版” “/data_20t/media/Fearless Hong Kong Version Director’s Cut 2006 Blu-Ray 1080p AVC LPCM 7.1”

配置 ipv6#

1
cat /etc/network/interfaces
2

3
# The loopback network interface
4
auto lo
5
iface lo inet loopback
6
auto enp3s0
7
iface enp3s0 inet dhcp
8
iface enp3s0 inet6 dhcp
9
autoconf 1
10
accept_ra 2
11
auto enp4s0
12
iface enp4s0 inet dhcp

重启网卡#

sudo /etc/init.d/networking restart

一句话笔记：常用mac命令

Thu, 15 Jul 2021 09:21:02 GMT

双网卡路由配置#

查看路由表 netstat -nr
删除路由 sudo route -v delete -net 172.20/24
添加路由 sudo route -n add -net 172.20.3.0 -netmask 255.255.255.0 192.168.123.1

文件系统远程挂载#

SMB

NFS

mount -t nfs -o nolock 172.20.4.106:/home /data/sync

开机挂载

开机自动挂载文件#

修改 /etc/fstab 文件，挂载命令如：

SMB

//192.168.22.111/shared /home/www/ cifs username=xxx,password=xxx,rw,dir_mode=0777,file_mode=0777 0 0

NFS

172.20.4.106:/home /data/sync nfs username=suqishuo,password=suqishuo@4.106,rw,dir_mode=0777,file_mode=0777 0 0

curl,apt 设置代理#

curl -x socks5h://192.168.3.125:9081 -LO http://google.com

sudo apt-get -o Acquire::http::proxy=“socks5h://192.168.3.125:9081/” update apt-get -o Acquire::http::proxy=“socks5h://192.168.3.125:9081/” install xxx

批量替换文件内容#

Terminal window

1
 sed -i 's/http:\/\/tracker\.m.com/https:\/\/tracker\.m\.com/' *.txt

一句话PT笔记

Thu, 15 Jul 2021 09:21:02 GMT

盒子（seedbox）限制汇总，H&R汇总#

https://www.kdocs.cn/l/sEi6Sg5iu

Android基于Modbus RTU协议通过蓝牙与蓝牙串口开发板通信

Mon, 08 Feb 2021 08:46:55 GMT

Android基于Modbus RTU协议通过蓝牙与蓝牙串口开发板通信#

原文

[TOC]

前言#

最近接到一位老师的项目，他们公司要求利用Android基于Modbus RTU协议通过蓝牙与蓝牙串口开发板通信，然后通过开发板控制硬件设备从而实现Android移动设备与硬件交互。所以今天我给大家分享下Android基于Modbus RTU协议的蓝牙通信。当然Android也可以直接通过串口利用Modbus RTU协议与开发板通信，或者基于Modbus TCP通信。至于非蓝牙非Modbus RTU协议通信，大家可以跳转到这位博主的博客：Steven Jon

实现原理#

要想实现Android与开发板通信，那么必将涉及到协议问题。Android采用蓝牙协议通信，而开发板使用的是串口的协议(Modbus协议)，那么应该如何实现让采用两种不同协议通信的设备进行交互呢？那当然是两种协议的套接啦，接下来我将以Modbus RTU协议给大家介绍下实现原理： (1) 在Android中我们不能直接将指令放在蓝牙帧的数据域内，因为这样不能满足Modbus RTU协议，因此开发板无法从蓝牙帧中正确解析出你的指令，所以我们应该先将指令数据按照Modbus RTU协议先进行指令封装，然后将封装好的Modbus RTU协议指令帧整个放在蓝牙帧的数据域内。这样当开发板获取蓝牙帧时会自动获取数据域内的数据，这时候将获取到含有指令的Modbus RTU协议帧，然后从含有指令的Modbus RTU协议帧中解析出指令操作。 (2) 当然开发板要想从蓝牙帧中自动提取数据域中的数据也是有条件的，那就是在开发板上必须加上串口转蓝牙接口。这个串口转蓝牙接口就是实现两种协议套接的核心。它的作用是如果获取到的是Android发出的蓝牙帧时自动提取数据区域内的Modbus RTU协议帧，而如果收到的是开发板发出的Modbus RTU协议帧时则自动将它封装到蓝牙帧中。都是文字的话大家是不是很难理解，那么接下来上原理图：

套接原理图：

在这里插入图片描述

功能原理图：

在这里插入图片描述

看完实现原理接下来介绍最重要的代码实现。

在Android上实现Modbus RTU Master#

在Android中针对Modbus RTU消息帧没有现成的组装模块，因此需要自己写。

组装Modbus RTU消息帧#

这里是将输入的指令转换成对应的Modbus RTU协议的帧。

1
     /**
2
     * 组装Modbus RTU消息帧
3
     * @param slave 从站地址号
4
     * @param function_code 功能码
5
     * @param starting_address 读取寄存器起始地址 / 写入寄存器地址 / 写入寄存器起始地址
6
     * @param quantity_of_x 读取寄存器个数 / 写入寄存器个数
7
     * @param output_value 需要写入单个寄存器的数值
8
     * @param output_values 需要写入多个寄存器的数组
9
     * @return 将整个消息帧转成byte[]
10
     * @throws ModbusError Modbus错误
11
     */
12
    synchronized private byte[] execute(int slave, int function_code, int starting_address, int quantity_of_x,
13
                                        int output_value, int[] output_values) throws ModbusError {
14
        //检查参数是否符合协议规定
15
        if (slave < 0 || slave > 0xff) {
16
            throw new ModbusError(ModbusErrorType.ModbusInvalidArgumentError, "Invalid slave " + slave);
17
        }
18
        if (starting_address < 0 || starting_address > 0xffff) {
19
            throw new ModbusError(ModbusErrorType.ModbusInvalidArgumentError, "Invalid starting_address " + starting_address);
20
        }
21
        if (quantity_of_x < 1 || quantity_of_x > 0xff) {
22
            throw new ModbusError(ModbusErrorType.ModbusInvalidArgumentError, "Invalid quantity_of_x " + quantity_of_x);
23
        }
24

25
        // 构造request
26
        ByteArrayWriter request = new ByteArrayWriter();
27
        //写入从站地址号
28
        request.writeInt8(slave);
29
        //根据功能码组装数据区
30
        //如果为读取寄存器指令
31
        if (function_code == ModbusFunction.READ_COILS || function_code == ModbusFunction.READ_DISCRETE_INPUTS
32
                || function_code == ModbusFunction.READ_INPUT_REGISTERS || function_code == ModbusFunction.READ_HOLDING_REGISTERS) {
33
            request.writeInt8(function_code);
34
            request.writeInt16(starting_address);
35
            request.writeInt16(quantity_of_x);
36

37
        } else if (function_code == ModbusFunction.WRITE_SINGLE_COIL || function_code == ModbusFunction.WRITE_SINGLE_REGISTER) {//写单个寄存器指令
38
            if (function_code == ModbusFunction.WRITE_SINGLE_COIL)
39
                if (output_value != 0) output_value = 0xff00;//如果为线圈寄存器（写1时为 FF 00,写0时为00 00）
40
            request.writeInt8(function_code);
41
            request.writeInt16(starting_address);
42
            request.writeInt16(output_value);
43

44
        } else if (function_code == ModbusFunction.WRITE_COILS) {//写多个线圈寄存器
45
            request.writeInt8(function_code);
46
            request.writeInt16(starting_address);
47
            request.writeInt16(quantity_of_x);
48

49
            //计算写入字节数
50
            int writeByteCount = (quantity_of_x / 8) + 1;/// 满足关系-> (w /8) + 1
51
            //写入数量 == 8 ,则写入字节数为1
52
            if (quantity_of_x % 8 == 0) {
53
                writeByteCount -= 1;
54
            }
55
            request.writeInt8(writeByteCount);
56

57
            int index = 0;
58
            //如果写入数据数量 > 8 ，则需要拆分开来
59
            int start = 0;//数组开始位置
60
            int end = 7;//数组结束位置
61
            int[] splitData = new int[8];
62
            //循环写入拆分数组，直到剩下最后一组 元素个数 <= 8 的数据
63
            while (writeByteCount > 1) {
64
                writeByteCount--;
65
                int sIndex = 0;
66
                for (index = start; index <= end; index++){
67
                    splitData [sIndex++] = output_values[index];
68
                }
69
                //数据反转 对于是否要反转要看你传过来的数据，如果高低位顺序正确则不用反转
70
                splitData = reverseArr(splitData);
71
                //写入拆分数组
72
                request.writeInt8(toDecimal(splitData));
73
                start = index;
74
                end += 8;
75
            }
76
            //写入最后剩下的数据
77
            int last = quantity_of_x - index;
78
            int[] tData = new int[last];
79
            System.arraycopy(output_values, index, tData, 0, last);
80
            //数据反转 对于是否要反转要看你传过来的数据，如果高低位顺序正确则不用反转
81
            tData = reverseArr(tData);
82
            request.writeInt8(toDecimal(tData));
83
        } else if (function_code == ModbusFunction.WRITE_HOLDING_REGISTERS) {//写多个保持寄存器
84
            request.writeInt8(function_code);
85
            request.writeInt16(starting_address);
86
            request.writeInt16(quantity_of_x);
87
            request.writeInt8(2 * quantity_of_x);
88
            //写入数据
89
            for (int v : output_values) {
90
                request.writeInt16(v);
91
            }
92
        } else {
93
            throw new ModbusError(ModbusErrorType.ModbusFunctionNotSupportedError, "Not support function " + function_code);
94
        }
95
        byte[] bytes = request.toByteArray();
96
        //计算CRC校验码
97
        int crc = CRC16.compute(bytes);
98
        request.writeInt16Reversal(crc);
99
        bytes = request.toByteArray();
100
        return bytes;
101
    }

展开收起

ModbusErrorType#

定义Modbus通讯错误类型

1
/**
2
 * 常见的Modbus通讯错误
3
 */
4
public enum ModbusErrorType {
5
    ModbusError,
6
    ModbusFunctionNotSupportedError,
7
    ModbusDuplicatedKeyError,
8
    ModbusMissingKeyError,
9
    ModbusInvalidBlockError,
10
    ModbusInvalidArgumentError,
11
    ModbusOverlapBlockError,
12
    ModbusOutOfBlockError,
13
    ModbusInvalidResponseError,
14
    ModbusInvalidRequestError,
15
    ModbusTimeoutError
16
}

展开收起

ModbusError#

1
public class ModbusError extends Exception {
2
    private int code;
3

4
    public ModbusError(int code, String message) {
5
        super(!TextUtils.isEmpty(message) ? message : "Modbus Error: Exception code = " + code);
6
        this.code = code;
7
    }
8

9
    public ModbusError(int code) {
10
        this(code, null);
11
    }
12

13
    public ModbusError(ModbusErrorType type, String message) {
14
        super(type.name() + ": " + message);
15
    }
16

17
    public ModbusError(String message) {
18
        super(message);
19
    }
20

21
    public int getCode() {
22
        return this.code;
23
    }
24
}

展开收起

ModbusFunction#

功能码定义

1
/**
2
 * 功能码（十进制显示）
3
 */
4
public class ModbusFunction {
5

6
    //读线圈寄存器
7
    public static final int READ_COILS = 1;
8

9
    //读离散输入寄存器
10
    public static final int READ_DISCRETE_INPUTS = 2;
11

12
    //读保持寄存器
13
    public static final int READ_HOLDING_REGISTERS = 3;
14

15
    //读输入寄存器
16
    public static final int READ_INPUT_REGISTERS = 4;
17

18
    //写单个线圈寄存器
19
    public static final int WRITE_SINGLE_COIL = 5;
20

21
    //写单个保持寄存器
22
    public static final int WRITE_SINGLE_REGISTER = 6;
23

24
    //写入多个线圈寄存器
25
    public static final int WRITE_COILS = 15;
26

27
    //写入多个保持寄存器
28
    public static final int WRITE_HOLDING_REGISTERS = 16;
29
}

展开收起

ByteArrayWriter#

1
public class ByteArrayWriter extends ByteArrayOutputStream {
2
    public ByteArrayWriter() {
3
        super();
4
    }
5

6
    public void writeInt8(byte b)
7
    {
8
        this.write(b);
9
    }
10

11
    public void writeInt8(int b)
12
    {
13
        this.write((byte)b);
14
    }
15

16
    public void writeInt16(int n) {
17
        byte[] bytes = ByteUtil.fromInt16(n);
18
        this.write(bytes, 0, bytes.length);
19
    }
20

21
    public void writeInt16Reversal(int n){
22
        byte[] bytes=ByteUtil.fromInt16Reversal(n);
23
        this.write(bytes,0,bytes.length);
24
    }
25

26
    public void writeInt32(int n) {
27
        byte[] bytes = ByteUtil.fromInt32(n);
28
        this.write(bytes, 0, bytes.length);
29
    }
30

31
    public void writeBytes(byte[] bs,int len){
32
        this.write(bs,0,len);
33
    }
34

35
}

展开收起

ByteUtil#

1
public class ByteUtil {
2

3
    public static String toHexString(byte[] input, String separator) {
4
        if (input==null) return null;
5

6
        StringBuilder sb = new StringBuilder();
7
        for (int i = 0; i < input.length; i++) {
8
            if (separator != null && sb.length() > 0) {
9
                sb.append(separator);
10
            }
11
            String str = Integer.toHexString(input[i] & 0xff);
12
            if (str.length() == 1) str = "0" + str;
13
            sb.append(str);
14
        }
15
        return sb.toString();
16
    }
17

18
    public static String toHexString(byte[] input) {
19
        return toHexString(input, " ");
20
    }
21

22
    public static byte[] fromInt32(int input){
23
        byte[] result=new byte[4];
24
        result[3]=(byte)(input >> 24 & 0xFF);
25
        result[2]=(byte)(input >> 16 & 0xFF);
26
        result[1]=(byte)(input >> 8 & 0xFF);
27
        result[0]=(byte)(input & 0xFF);
28
        return result;
29
    }
30

31
    public static byte[] fromInt16(int input){
32
        byte[] result=new byte[2];
33
        result[0]=(byte)(input >> 8 & 0xFF);
34
        result[1]=(byte)(input & 0xFF);
35
        return result;
36
    }
37

38
    public static byte[] fromInt16Reversal(int input){
39
        byte[] result=new byte[2];
40
        result[1]=(byte)(input>>8&0xFF);
41
        result[0]=(byte)(input&0xFF);
42
        return result;
43
    }
44

45
}

展开收起

CRC16#

1
public class CRC16 {
2
    private static final byte[] crc16_tab_h = { (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40,
3
            (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x01, (byte) 0xC0, (byte) 0x80,
4
            (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0,
5
            (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x00,
6
            (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41,
7
            (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81,
8
            (byte) 0x40, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0,
9
            (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01,
10
            (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41,
11
            (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80,
12
            (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x00, (byte) 0xC1,
13
            (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00,
14
            (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41,
15
            (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81,
16
            (byte) 0x40, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0,
17
            (byte) 0x80, (byte) 0x41, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00,
18
            (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41,
19
            (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x00, (byte) 0xC1, (byte) 0x81,
20
            (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x01, (byte) 0xC0,
21
            (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x00,
22
            (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41,
23
            (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80,
24
            (byte) 0x41, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1,
25
            (byte) 0x81, (byte) 0x40, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01,
26
            (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41,
27
            (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80,
28
            (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x00, (byte) 0xC1,
29
            (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00,
30
            (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41,
31
            (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81,
32
            (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1,
33
            (byte) 0x81, (byte) 0x40, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x01,
34
            (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41,
35
            (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40, (byte) 0x00, (byte) 0xC1, (byte) 0x81,
36
            (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1,
37
            (byte) 0x81, (byte) 0x40, (byte) 0x01, (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x01,
38
            (byte) 0xC0, (byte) 0x80, (byte) 0x41, (byte) 0x00, (byte) 0xC1, (byte) 0x81, (byte) 0x40 };
39

40
    private static final byte[] crc16_tab_l = { (byte) 0x00, (byte) 0xC0, (byte) 0xC1, (byte) 0x01,
41
            (byte) 0xC3, (byte) 0x03, (byte) 0x02, (byte) 0xC2, (byte) 0xC6, (byte) 0x06, (byte) 0x07,
42
            (byte) 0xC7, (byte) 0x05, (byte) 0xC5, (byte) 0xC4, (byte) 0x04, (byte) 0xCC, (byte) 0x0C,
43
            (byte) 0x0D, (byte) 0xCD, (byte) 0x0F, (byte) 0xCF, (byte) 0xCE, (byte) 0x0E, (byte) 0x0A,
44
            (byte) 0xCA, (byte) 0xCB, (byte) 0x0B, (byte) 0xC9, (byte) 0x09, (byte) 0x08, (byte) 0xC8,
45
            (byte) 0xD8, (byte) 0x18, (byte) 0x19, (byte) 0xD9, (byte) 0x1B, (byte) 0xDB, (byte) 0xDA,
46
            (byte) 0x1A, (byte) 0x1E, (byte) 0xDE, (byte) 0xDF, (byte) 0x1F, (byte) 0xDD, (byte) 0x1D,
47
            (byte) 0x1C, (byte) 0xDC, (byte) 0x14, (byte) 0xD4, (byte) 0xD5, (byte) 0x15, (byte) 0xD7,
48
            (byte) 0x17, (byte) 0x16, (byte) 0xD6, (byte) 0xD2, (byte) 0x12, (byte) 0x13, (byte) 0xD3,
49
            (byte) 0x11, (byte) 0xD1, (byte) 0xD0, (byte) 0x10, (byte) 0xF0, (byte) 0x30, (byte) 0x31,
50
            (byte) 0xF1, (byte) 0x33, (byte) 0xF3, (byte) 0xF2, (byte) 0x32, (byte) 0x36, (byte) 0xF6,
51
            (byte) 0xF7, (byte) 0x37, (byte) 0xF5, (byte) 0x35, (byte) 0x34, (byte) 0xF4, (byte) 0x3C,
52
            (byte) 0xFC, (byte) 0xFD, (byte) 0x3D, (byte) 0xFF, (byte) 0x3F, (byte) 0x3E, (byte) 0xFE,
53
            (byte) 0xFA, (byte) 0x3A, (byte) 0x3B, (byte) 0xFB, (byte) 0x39, (byte) 0xF9, (byte) 0xF8,
54
            (byte) 0x38, (byte) 0x28, (byte) 0xE8, (byte) 0xE9, (byte) 0x29, (byte) 0xEB, (byte) 0x2B,
55
            (byte) 0x2A, (byte) 0xEA, (byte) 0xEE, (byte) 0x2E, (byte) 0x2F, (byte) 0xEF, (byte) 0x2D,
56
            (byte) 0xED, (byte) 0xEC, (byte) 0x2C, (byte) 0xE4, (byte) 0x24, (byte) 0x25, (byte) 0xE5,
57
            (byte) 0x27, (byte) 0xE7, (byte) 0xE6, (byte) 0x26, (byte) 0x22, (byte) 0xE2, (byte) 0xE3,
58
            (byte) 0x23, (byte) 0xE1, (byte) 0x21, (byte) 0x20, (byte) 0xE0, (byte) 0xA0, (byte) 0x60,
59
            (byte) 0x61, (byte) 0xA1, (byte) 0x63, (byte) 0xA3, (byte) 0xA2, (byte) 0x62, (byte) 0x66,
60
            (byte) 0xA6, (byte) 0xA7, (byte) 0x67, (byte) 0xA5, (byte) 0x65, (byte) 0x64, (byte) 0xA4,
61
            (byte) 0x6C, (byte) 0xAC, (byte) 0xAD, (byte) 0x6D, (byte) 0xAF, (byte) 0x6F, (byte) 0x6E,
62
            (byte) 0xAE, (byte) 0xAA, (byte) 0x6A, (byte) 0x6B, (byte) 0xAB, (byte) 0x69, (byte) 0xA9,
63
            (byte) 0xA8, (byte) 0x68, (byte) 0x78, (byte) 0xB8, (byte) 0xB9, (byte) 0x79, (byte) 0xBB,
64
            (byte) 0x7B, (byte) 0x7A, (byte) 0xBA, (byte) 0xBE, (byte) 0x7E, (byte) 0x7F, (byte) 0xBF,
65
            (byte) 0x7D, (byte) 0xBD, (byte) 0xBC, (byte) 0x7C, (byte) 0xB4, (byte) 0x74, (byte) 0x75,
66
            (byte) 0xB5, (byte) 0x77, (byte) 0xB7, (byte) 0xB6, (byte) 0x76, (byte) 0x72, (byte) 0xB2,
67
            (byte) 0xB3, (byte) 0x73, (byte) 0xB1, (byte) 0x71, (byte) 0x70, (byte) 0xB0, (byte) 0x50,
68
            (byte) 0x90, (byte) 0x91, (byte) 0x51, (byte) 0x93, (byte) 0x53, (byte) 0x52, (byte) 0x92,
69
            (byte) 0x96, (byte) 0x56, (byte) 0x57, (byte) 0x97, (byte) 0x55, (byte) 0x95, (byte) 0x94,
70
            (byte) 0x54, (byte) 0x9C, (byte) 0x5C, (byte) 0x5D, (byte) 0x9D, (byte) 0x5F, (byte) 0x9F,
71
            (byte) 0x9E, (byte) 0x5E, (byte) 0x5A, (byte) 0x9A, (byte) 0x9B, (byte) 0x5B, (byte) 0x99,
72
            (byte) 0x59, (byte) 0x58, (byte) 0x98, (byte) 0x88, (byte) 0x48, (byte) 0x49, (byte) 0x89,
73
            (byte) 0x4B, (byte) 0x8B, (byte) 0x8A, (byte) 0x4A, (byte) 0x4E, (byte) 0x8E, (byte) 0x8F,
74
            (byte) 0x4F, (byte) 0x8D, (byte) 0x4D, (byte) 0x4C, (byte) 0x8C, (byte) 0x44, (byte) 0x84,
75
            (byte) 0x85, (byte) 0x45, (byte) 0x87, (byte) 0x47, (byte) 0x46, (byte) 0x86, (byte) 0x82,
76
            (byte) 0x42, (byte) 0x43, (byte) 0x83, (byte) 0x41, (byte) 0x81, (byte) 0x80, (byte) 0x40 };
77

78
    /**
79
     * 计算CRC16校验
80
     *
81
     * @param data
82
     *            需要计算的数组
83
     * @return CRC16校验值
84
     */
85
    public static int compute(byte[] data) {
86
        return compute(data, 0, data.length);
87
    }
88

89
    /**
90
     * 计算CRC16校验
91
     *
92
     * @param data
93
     *            需要计算的数组
94
     * @param offset
95
     *            起始位置
96
     * @param len
97
     *            长度
98
     * @return CRC16校验值
99
     */
100
    public static int compute(byte[] data, int offset, int len) {
101
        return compute(data, offset, len, 0xffff);
102
    }
103

104
    /**
105
     * 计算CRC16校验
106
     *
107
     * @param data
108
     *            需要计算的数组
109
     * @param offset
110
     *            起始位置
111
     * @param len
112
     *            长度
113
     * @param preval
114
     *            之前的校验值
115
     * @return CRC16校验值
116
     */
117
    public static int compute(byte[] data, int offset, int len, int preval) {
118
        int ucCRCHi = (preval & 0xff00) >> 8;
119
        int ucCRCLo = preval & 0x00ff;
120
        int iIndex;
121
        for (int i = 0; i < len; ++i) {
122
            iIndex = (ucCRCLo ^ data[offset + i]) & 0x00ff;
123
            ucCRCLo = ucCRCHi ^ crc16_tab_h[iIndex];
124
            ucCRCHi = crc16_tab_l[iIndex];
125
        }
126
        int result=((ucCRCHi & 0x00ff) << 8) | (ucCRCLo & 0x00ff) & 0xffff;
127
        return result;
128
    }
129
}

展开收起

ModbusRtuMaster完整代码#

这个类主要的功能就是将输入的指令转换成符合ModbusRtu协议的指令并返回，之后Android只需将返回的byte[]类型的值用蓝牙发送即可。

1
import java.util.Formatter;
2

3
public class ModbusRtuMaster {
4

5

6
    /**
7
     * 组装Modbus RTU消息帧
8
     *
9
     * @param slave            从站地址号
10
     * @param function_code    功能码
11
     * @param starting_address 读取寄存器起始地址 / 写入寄存器地址 / 写入寄存器起始地址
12
     * @param quantity_of_x    读取寄存器个数 / 写入寄存器个数
13
     * @param output_value     需要写入单个寄存器的数值
14
     * @param output_values    需要写入多个寄存器的数组
15
     * @return 将整个消息帧转成byte[]
16
     * @throws ModbusError Modbus错误
17
     */
18
    synchronized private byte[] execute(int slave, int function_code, int starting_address, int quantity_of_x,
19
                                        int output_value, int[] output_values) throws ModbusError {
20
        //检查参数是否符合协议规定
21
        if (slave < 0 || slave > 0xff) {
22
            throw new ModbusError(ModbusErrorType.ModbusInvalidArgumentError, "Invalid slave " + slave);
23
        }
24
        if (starting_address < 0 || starting_address > 0xffff) {
25
            throw new ModbusError(ModbusErrorType.ModbusInvalidArgumentError, "Invalid starting_address " + starting_address);
26
        }
27
        if (quantity_of_x < 1 || quantity_of_x > 0xff) {
28
            throw new ModbusError(ModbusErrorType.ModbusInvalidArgumentError, "Invalid quantity_of_x " + quantity_of_x);
29
        }
30

31
        // 构造request
32
        ByteArrayWriter request = new ByteArrayWriter();
33
        //写入从站地址号
34
        request.writeInt8(slave);
35
        //根据功能码组装数据区
36
        //如果为读取寄存器指令
37
        if (function_code == ModbusFunction.READ_COILS || function_code == ModbusFunction.READ_DISCRETE_INPUTS
38
                || function_code == ModbusFunction.READ_INPUT_REGISTERS || function_code == ModbusFunction.READ_HOLDING_REGISTERS) {
39
            request.writeInt8(function_code);
40
            request.writeInt16(starting_address);
41
            request.writeInt16(quantity_of_x);
42

43
        } else if (function_code == ModbusFunction.WRITE_SINGLE_COIL || function_code == ModbusFunction.WRITE_SINGLE_REGISTER) {//写单个寄存器指令
44
            if (function_code == ModbusFunction.WRITE_SINGLE_COIL)
45
                if (output_value != 0) output_value = 0xff00;//如果为线圈寄存器（写1时为 FF 00,写0时为00 00）
46
            request.writeInt8(function_code);
47
            request.writeInt16(starting_address);
48
            request.writeInt16(output_value);
49

50
        } else if (function_code == ModbusFunction.WRITE_COILS) {//写多个线圈寄存器
51
            request.writeInt8(function_code);
52
            request.writeInt16(starting_address);
53
            request.writeInt16(quantity_of_x);
54

55
            //计算写入字节数
56
            int writeByteCount = (quantity_of_x / 8) + 1;/// 满足关系-> (w /8) + 1
57
            //写入数量 == 8 ,则写入字节数为1
58
            if (quantity_of_x % 8 == 0) {
59
                writeByteCount -= 1;
60
            }
61
            request.writeInt8(writeByteCount);
62

63
            int index = 0;
64
            //如果写入数据数量 > 8 ，则需要拆分开来
65
            int start = 0;//数组开始位置
66
            int end = 7;//数组结束位置
67
            int[] splitData = new int[8];
68
            //循环写入拆分数组，直到剩下最后一组 元素个数 <= 8 的数据
69
            while (writeByteCount > 1) {
70
                writeByteCount--;
71
                int sIndex = 0;
72
                for (index = start; index <= end; index++) {
73
                    splitData[sIndex++] = output_values[index];
74
                }
75
                //数据反转 对于是否要反转要看你传过来的数据，如果高低位顺序正确则不用反转
76
                splitData = reverseArr(splitData);
77
                //写入拆分数组
78
                request.writeInt8(toDecimal(splitData));
79
                start = index;
80
                end += 8;
81
            }
82
            //写入最后剩下的数据
83
            int last = quantity_of_x - index;
84
            int[] tData = new int[last];
85
            System.arraycopy(output_values, index, tData, 0, last);
86
            //数据反转 对于是否要反转要看你传过来的数据，如果高低位顺序正确则不用反转
87
            tData = reverseArr(tData);
88
            request.writeInt8(toDecimal(tData));
89
        } else if (function_code == ModbusFunction.WRITE_HOLDING_REGISTERS) {//写多个保持寄存器
90
            request.writeInt8(function_code);
91
            request.writeInt16(starting_address);
92
            request.writeInt16(quantity_of_x);
93
            request.writeInt8(2 * quantity_of_x);
94
            //写入数据
95
            for (int v : output_values) {
96
                request.writeInt16(v);
97
            }
98
        } else {
99
            throw new ModbusError(ModbusErrorType.ModbusFunctionNotSupportedError, "Not support function " + function_code);
100
        }
101
        byte[] bytes = request.toByteArray();
102
        //计算CRC校验码
103
        int crc = CRC16.compute(bytes);
104
        request.writeInt16Reversal(crc);
105
        bytes = request.toByteArray();
106
        return bytes;
107
    }
108

109
    /**
110
     * 读多个线圈寄存器
111
     *
112
     * @param slave          从站地址
113
     * @param startAddress   起始地址
114
     * @param numberOfPoints 读取线圈寄存器个数
115
     * @throws ModbusError Modbus错误
116
     */
117
    public byte[] readCoils(int slave, int startAddress, int numberOfPoints) throws ModbusError {
118
        byte[] sendBytes = execute(slave, ModbusFunction.READ_COILS, startAddress, numberOfPoints, 0, null);
119
        return sendBytes;
120
    }
121

122
    //读单个线圈寄存器
123
    public byte[] readCoil(int slave, int address) throws ModbusError {
124
        byte[] sendBytes = readCoils(slave, address, 1);
125
        return sendBytes;
126
    }
127

128
    /**
129
     * 读多个保持寄存器
130
     *
131
     * @param slave          从站地址
132
     * @param startAddress   起始地址
133
     * @param numberOfPoints 读取保持寄存器个数
134
     * @throws ModbusError Modbus错误
135
     */
136
    public byte[] readHoldingRegisters(int slave, int startAddress, int numberOfPoints) throws ModbusError {
137
        byte[] sendBytes = execute(slave, ModbusFunction.READ_HOLDING_REGISTERS, startAddress, numberOfPoints, 0, null);
138

139
        return sendBytes;
140
    }
141

142
    //读单个保持寄存器
143
    public byte[] readHoldingRegister(int slave, int address) throws ModbusError {
144
        byte[] sendBytes = readHoldingRegisters(slave, address, 1);
145
        return sendBytes;
146
    }
147

148

149
    /**
150
     * 读多个输入寄存器
151
     *
152
     * @param slave          从站地址
153
     * @param startAddress   起始地址
154
     * @param numberOfPoints 读取输入寄存器个数
155
     * @throws ModbusError Modbus错误
156
     */
157
    public byte[] readInputRegisters(int slave, int startAddress, int numberOfPoints) throws ModbusError {
158
        byte[] sendBytes = execute(slave, ModbusFunction.READ_INPUT_REGISTERS, startAddress, numberOfPoints, 0, null);
159
        return sendBytes;
160
    }
161

162
    //读单个输入寄存器
163
    public byte[] readInputRegister(int slave, int address) throws ModbusError {
164
        byte[] sendBytes = readInputRegisters(slave, address, 1);
165
        return sendBytes;
166
    }
167

168
    /**
169
     * 读多个离散输入寄存器
170
     *
171
     * @param slave          从站地址
172
     * @param startAddress   起始地址
173
     * @param numberOfPoints 读取离散输入寄存器个数
174
     * @throws ModbusError Modbus错误
175
     */
176
    public byte[] readDiscreteInputs(int slave, int startAddress, int numberOfPoints) throws ModbusError {
177
        byte[] sendBytes = execute(slave, ModbusFunction.READ_DISCRETE_INPUTS, startAddress, numberOfPoints, 0, null);
178
        return sendBytes;
179
    }
180

181
    //读单个离散输入寄存器
182
    public byte[] readDiscreteInput(int slave, int address) throws ModbusError {
183
        byte[] sendBytes = readDiscreteInputs(slave, address, 1);
184
        return sendBytes;
185
    }
186

187
    /**
188
     * 写单个线圈寄存器
189
     *
190
     * @param slave   从站地址
191
     * @param address 写入寄存器地址
192
     * @param value   写入值（true/false)
193
     * @throws ModbusError Modbus错误
194
     */
195
    public byte[] writeSingleCoil(int slave, int address, boolean value) throws ModbusError {
196
        byte[] sendBytes = execute(slave, ModbusFunction.WRITE_SINGLE_COIL, address, 1, value ? 1 : 0, null);
197
        return sendBytes;
198
    }
199

200
    /**
201
     * 写单个保持寄存器
202
     *
203
     * @param slave   从站地址
204
     * @param address 写入寄存器地址
205
     * @param value   写入值
206
     * @throws ModbusError Modbus错误
207
     */
208
    public byte[] writeSingleRegister(int slave, int address, int value) throws ModbusError {
209
        byte[] sendBytes = execute(slave, ModbusFunction.WRITE_SINGLE_REGISTER, address, 1, value, null);
210
        return sendBytes;
211
    }
212

213
    /**
214
     * 写入多个保持寄存器
215
     *
216
     * @param slave   从站地址
217
     * @param address 写入寄存器地址
218
     * @param sCount  写入寄存器个数
219
     * @param data    写入数据
220
     * @throws ModbusError
221
     */
222
    public byte[] writeHoldingRegisters(int slave, int address, int sCount, int[] data) throws ModbusError {
223
        byte[] sendBytes = execute(slave, ModbusFunction.WRITE_HOLDING_REGISTERS, address, sCount, 0, data);
224
        return sendBytes;
225
    }
226

227
    /**
228
     * 写入多个位
229
     *
230
     * @param slave   从站地址
231
     * @param address 写入寄存器地址
232
     * @param bCount  写入寄存器个数
233
     * @param data    写入数据{1,0}
234
     * @throws ModbusError
235
     */
236
    public byte[] writeCoils(int slave, int address, int bCount, int[] data) throws ModbusError {
237
        byte[] sendBytes = execute(slave, ModbusFunction.WRITE_COILS, address, bCount, 0, data);
238
        return sendBytes;
239
    }
240

241

242
    //将数组反转
243
    private int[] reverseArr(int[] arr) {
244
        int[] tem = new int[arr.length];
245
        for (int i = 0; i < arr.length; i++) {
246
            tem[i] = arr[arr.length - 1 - i];
247
        }
248
        return tem;
249
    }
250

251
    /**
252
     * 字节转换为 16 进制字符串
253
     *
254
     * @param b 字节
255
     * @return Hex 字符串
256
     */
257
    static String byte2Hex(byte b) {
258
        StringBuilder hex = new StringBuilder(Integer.toHexString(b));
259
        if (hex.length() > 2) {
260
            hex = new StringBuilder(hex.substring(hex.length() - 2));
261
        }
262
        while (hex.length() < 2) {
263
            hex.insert(0, "0");
264
        }
265
        return hex.toString();
266
    }
267

268

269
    /**
270
     * 字节数组转换为 16 进制字符串
271
     *
272
     * @param bytes 字节数组
273
     * @return Hex 字符串
274
     */
275
    static String bytes2Hex(byte[] bytes) {
276
        Formatter formatter = new Formatter();
277
        for (byte b : bytes) {
278
            formatter.format("%02x ", b);
279
        }
280
        String hash = formatter.toString();
281
        formatter.close();
282
        return hash;
283
    }
284

285
    //将int[1,0,0,1,1,0]数组转换为十进制数据
286
    private int toDecimal(int[] data) {
287
        int result = 0;
288
        if (data != null) {
289
            StringBuilder sData = new StringBuilder();
290
            for (int d : data) {
291
                sData.append(d);
292
            }
293
            try {
294
                result = Integer.parseInt(sData.toString(), 2);
295
            } catch (NumberFormatException e) {
296
                result = -1;
297
            }
298

299
        }
300
        return result;
301
    }
302
}

展开收起

在Android上实现用蓝牙传递Modbus Rtu协议帧#

今天分享的是Android如何基于Modbus RTU协议与蓝牙串口开发板通信，至于Android如何搜索蓝牙设备，如何连接我这就不多做介绍了，网上有很多博主做了一大堆了。接下来来看看我们写好的ModbusRtuMaster怎么使用吧。

1
//首先在你的activity中定义一个ModbusRtuMaster类型
2
private ModbusRtuMaster modbusRtuMaster;
3
//然后在activity中的onCreate方法里初始化ModbusRtuMaster
4
modbusRtuMaster = new ModbusRtuMaster();
5
//最后利用ModbusRtuMaster对输入的指令进行协议封装并接收返回结果
6
//这时候results就是一个符合ModbusRtu协议的消息针了
7
byte[] results = modbusRtuMaster.writeHoldingRegisters(Rs485, Rsaddress, Hvalue.length, Hvalue);
8
//接下来可以把results用蓝牙发给你的蓝牙串口开发板了
9
private final OutputStream mmOutStream;
10
mmOutStream.write(results)

字节数组转换为 16 进制字符串的方法#

这里我再提下ModbusRtuMaster里面的bytes2Hex方法，如果你想把转换后的指令或者是串口返回的数据显示在Android设备上，那么必须将其转化为Hex类型的16进制字符串，如果不转换成Hex那么显示出来将是乱码等，因为那些数据是btye类型，然后就是这里不能使用 new String(byte[]) 去将byte数组转换成string，否则将显示成符号字母，请务必按照我在ModbusRtuMaster内写的bytes2Hex将字节数组转换为 16 进制字符串，再输出显示。

1
static String bytes2Hex(byte[] bytes) {
2
        Formatter formatter = new Formatter();
3
        for (byte b : bytes) {
4
            formatter.format("%02x ", b);
5
        }
6
        String hash = formatter.toString();
7
        formatter.close();
8
        return hash;
9
    }

如何使用bytes2Hex

1
String result = modbusRtuMaster.bytes2Hex(results);

最终效果#

最后让我们来看看使用ModbusRtuMaster返回帧通过蓝牙传给蓝牙串口开发板的效果吧！(蓝色代表发送指令，绿色代表接收开发板返回的数据)

在这里插入图片描述

以上就是《Android基于ModbusRtu协议通过蓝牙与蓝牙串口开发板通信》的全部内容了，我也是第一次使用Android去通信开发板与硬件交互。这里非常感谢另一位博主的文章 Steven Jon，我也是借鉴了他博客中的一篇关于ModbusRtuMaster的文章才实现通信的，对其他通信方法感兴趣的小伙伴可以点击去Steven Jon大佬的博客继续学习。

ADB 操作命令详解及用法大全

Mon, 08 Feb 2021 03:46:55 GMT

[TOC]

一、ADB是什么？#

ADB，即 Android Debug Bridge 是一种允许模拟器或已连接的 Android 设备进行通信的命令行工具，它可为各种设备操作提供便利，如安装和调试应用，并提供对 Unix shell（可用来在模拟器或连接的设备上运行各种命令）的访问。可以在Android SDK/platform-tools中找到 adb 工具或下载 ADB Kits 。

二、ADB有什么作用？#

ADB 是 Android SDK 里的一个工具, 用这个工具可以直接操作管理Android模拟器或者真实的Android设备。它的主要功能有:

在设备上运行Shell命令；将本地APK软件安装至模拟器或Android设备；
管理设备或手机模拟器上的预定端口；
在设备或手机模拟器上复制或粘贴文件。

ADB 是一个客户端-服务器程序程序，包括三个组件：

客户端：该组件发送命令。客户端在开发计算机上运行。您可以通过发出 adb 命令从命令行终端调用客户端。
后台程序：该组件在设备上运行命令。后台程序在每个模拟器或设备实例上作为后台进程运行。
服务器：该组件管理客户端和后台程序之间的通信。服务器在开发计算机上作为后台进程运行。

三、ADB命令语法#

adb 命令的基本语法如下：

1
adb [-d|-e|-s <serial-number>] <command>
2
1

单一设备/模拟器连接#

如果只有一个设备/模拟器连接时，可以省略掉 [-d|-e|-s <serial-number>] 这一部分，直接使用 adb <command>。

多个设备/模拟器连接#

如果有多个设备/模拟器连接，则需要为命令指定目标设备，下表是指定目标设备的命令选项：

参数	含义
-d	指定当前唯一通过 USB 连接的 Android 设备为命令目标
-e	指定当前唯一运行的模拟器为命令目标
-s	`<serial-number>` 指定相应设备序列号的设备/模拟器为命令目标

在多个设备/模拟器连接的情况下较常用的是 -s <serial-number> 参数，serial-number是指设备的设备序列号，可以通过 adb devices 命令获取。

四、ADB常用命令#

4.1 基本命令#

4.1.1 查看adb的版本信息#

1
adb version
2
1

4.1.2 启动adb#

1
adb start-server
2
1

一般无需手动执行此命令，在运行 adb 命令时若发现 adb server 没有启动会自动调起。

4.1.3 停止adb#

1
adb kill-server
2
1

4.1.4 以 root 权限运行 adbd#

1
adb root
2
1

4.1.5 指定 adb server 的网络端口#

1
adb -P <port> start-server
2
1

ADB的默认端口为 5037。

4.1.6 查询已连接的设备/模拟器列表#

1
adb devices
2
1

4.2 设备连接管理#

4.2.1 USB 连接#

通过 USB 连接来正常使用 adb 需要以下步骤：

确认硬件状态正常(包括 Android 设备处于正常开机状态，USB 连接线和各种接口完好)。
Android 设备的开发者选项和 USB 调试模式已开启(可以在「设置」-「开发者选项」-「USB调试」打开USB调试)。
确认设备驱动状态正常(安装ADB驱动程序)。
通过 USB 线连接好电脑和设备后确认状态。
通过 adb devices 命令查看设备连接情况。

4.2.2 WLAN 连接（需要 USB 线）#

借助 USB 通过 WiFi 连接来正常使用 adb 需要以下步骤：操作步骤：

将 Android 设备与要运行 adb 的电脑连接到同一个 WiFi。
将设备与电脑通过 USB 线连接(可通过 adb devices 命令查看设备连接情况)。
通过 adb tcpip 5555 命令让设备在 5555 端口监听 TCP/IP 连接。
断开 USB 连接。
找到设备的 IP 地址(可以在「设置」-「关于手机」-「状态信息」-「IP地址」查看 IP 地址)。
通过 adb connect <device-ip-address> 命令使用 IP 地址将 Android 设备与电脑连接。
通过 adb devices 命令查看设备连接情况。
使用完毕后可通过 adb disconnect <device-ip-address> 命令断开无线连接。

4.2.3 WLAN 连接（无需借助 USB 线）#

注：需要 root 权限。不借助 USB 通过 WiFi 连接来正常使用 adb 需要以下步骤：

在 Android 设备上安装一个终端模拟器(可通过Terminal Emulator for Android Downloads下载)。
将 Android 设备与要运行 adb 的电脑连接到同一个 WiFi。
打开 Android 设备上的终端模拟器，在里面依次运行命令：

su setprop service.adb.tcp.port 5555
找到设备的 IP 地址(可以在「设置」-「关于手机」-「状态信息」-「IP地址」查看 IP 地址)。
通过 adb connect <device-ip-address> 命令使用 IP 地址将 Android 设备与电脑连接。
通过 adb devices 命令查看设备连接情况。

4.2.4 WiFi 连接转为 USB 连接#

通过adb usb命令以USB模式重新启动ADB：

1
adb usb
2
1

4.3 应用管理#

4.3.1 查看应用列表#

查看应用列表的基本命令格式是：

1
adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]
2
1

adb shell pm list packages 后面可以跟一些可选参数进行过滤查看不同的列表，可用参数及含义如下：

参数	显示列表
无	所有应用
-f	显示应用关联的 apk 文件
-d	只显示 disabled 的应用
-e	只显示 enabled 的应用
-s	只显示系统应用
-3	只显示第三方应用
-i	显示应用的 installer
-u	包含已卸载应用
`<filter>`	包名包含 `<filter>` 字符串

4.3.1.1 查看所有应用#

1
adb shell pm list packages
2
1

4.3.1.2 查看系统应用#

1
adb shell pm list packages -s
2
1

4.3.1.3 查看第三方应用#

1
adb shell pm list packages -3
2
1

4.3.1.4 包名包含某字符串的应用#

比如要查看包名包含字符串 huawei 的应用列表，命令：

1
adb shell pm list packages huawei
2
1

4.3.2 安装应用#

安装应用的基本命令格式是：

1
adb install [-l] [-r] [-t] [-s] [-d] [-g] <apk-file>
2
1

adb install 后面可以跟一些可选参数来控制安装 APK 的行为，可用参数及含义如下：

参数	含义
-l	将应用安装到保护目录 /mnt/asec
-r	允许覆盖安装
-t	允许安装 AndroidManifest.xml 里 application 指定 android=“true” 的应用
-s	将应用安装到 sdcard
-d	允许降级覆盖安装
-g	授予所有运行时权限

运行命令后可以看到输出内容，包含安装进度和状态，安装状态如下：

Success：代表安装成功。
Failure：代表安装失败。APK 安装失败的情况有很多，Failure状态之后有安装失败输出代码。常见安装失败输出代码、含义及可能的解决办法如下：

输出代码	含义	解决办法
INSTALL_FAILED_ALREADY_EXISTS	应用已经存在，或卸载了但没卸载干净	adb install 时使用 -r 参数，或者先 adb uninstall 再安装
INSTALL_FAILED_INVALID_APK	无效的 APK 文件
INSTALL_FAILED_INVALID_URI	无效的 APK 文件名	确保 APK 文件名里无中文
INSTALL_FAILED_INSUFFICIENT_STORAGE	空间不足	清理空间
INSTALL_FAILED_DUPLICATE_PACKAGE	已经存在同名程序
INSTALL_FAILED_NO_SHARED_USER	请求的共享用户不存在
INSTALL_FAILED_UPDATE_INCOMPATIBLE	以前安装过同名应用，但卸载时数据没有移除；或者已安装该应用，但签名不一致	先 adb uninstall 再安装
INSTALL_FAILED_SHARED_USER_INCOMPATIBLE	请求的共享用户存在但签名不一致
INSTALL_FAILED_MISSING_SHARED_LIBRARY	安装包使用了设备上不可用的共享库
INSTALL_FAILED_REPLACE_COULDNT_DELETE	替换时无法删除
INSTALL_FAILED_DEXOPT	dex 优化验证失败或空间不足
INSTALL_FAILED_OLDER_SDK	设备系统版本低于应用要求
INSTALL_FAILED_CONFLICTING_PROVIDER	设备里已经存在与应用里同名的 content provider
INSTALL_FAILED_NEWER_SDK	设备系统版本高于应用要求
INSTALL_FAILED_TEST_ONLY	应用是 test-only 的，但安装时没有指定 -t 参数
INSTALL_FAILED_CPU_ABI_INCOMPATIBLE	包含不兼容设备 CPU 应用程序二进制接口的 native code
INSTALL_FAILED_MISSING_FEATURE	应用使用了设备不可用的功能
INSTALL_FAILED_CONTAINER_ERROR	1. sdcard 访问失败;2. 应用签名与 ROM 签名一致，被当作内置应用。	1. 确认 sdcard 可用，或者安装到内置存储;2. 打包时不与 ROM 使用相同签名。
INSTALL_FAILED_INVALID_INSTALL_LOCATION	1. 不能安装到指定位置;2. 应用签名与 ROM 签名一致，被当作内置应用。	1. 切换安装位置，添加或删除 -s 参数;2. 打包时不与 ROM 使用相同签名。
INSTALL_FAILED_MEDIA_UNAVAILABLE	安装位置不可用	一般为 sdcard，确认 sdcard 可用或安装到内置存储
INSTALL_FAILED_VERIFICATION_TIMEOUT	验证安装包超时
INSTALL_FAILED_VERIFICATION_FAILURE	验证安装包失败
INSTALL_FAILED_PACKAGE_CHANGED	应用与调用程序期望的不一致
INSTALL_FAILED_UID_CHANGED	以前安装过该应用，与本次分配的 UID 不一致	清除以前安装过的残留文件
INSTALL_FAILED_VERSION_DOWNGRADE	已经安装了该应用更高版本	使用 -d 参数
INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE	已安装 target SDK 支持运行时权限的同名应用，要安装的版本不支持运行时权限
INSTALL_PARSE_FAILED_NOT_APK	指定路径不是文件，或不是以 .apk 结尾
INSTALL_PARSE_FAILED_BAD_MANIFEST	无法解析的 AndroidManifest.xml 文件
INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION	解析器遇到异常
INSTALL_PARSE_FAILED_NO_CERTIFICATES	安装包没有签名
INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES	已安装该应用，且签名与 APK 文件不一致	先卸载设备上的该应用，再安装
INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING	解析 APK 文件时遇到 CertificateEncodingException
INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME	manifest 文件里没有或者使用了无效的包名
INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID	manifest 文件里指定了无效的共享用户 ID
INSTALL_PARSE_FAILED_MANIFEST_MALFORMED	解析 manifest 文件时遇到结构性错误
INSTALL_PARSE_FAILED_MANIFEST_EMPTY	在 manifest 文件里找不到找可操作标签（instrumentation 或 application）
INSTALL_FAILED_INTERNAL_ERROR	因系统问题安装失败
INSTALL_FAILED_USER_RESTRICTED	用户被限制安装应用
INSTALL_FAILED_DUPLICATE_PERMISSION	应用尝试定义一个已经存在的权限名称
INSTALL_FAILED_NO_MATCHING_ABIS	应用包含设备的应用程序二进制接口不支持的 native code
INSTALL_CANCELED_BY_USER	应用安装需要在设备上确认，但未操作设备或点了取消	在设备上同意安装
INSTALL_FAILED_ACWF_INCOMPATIBLE	应用程序与设备不兼容
INSTALL_FAILED_TEST_ONLY	APK 文件是使用 Android Studio 直接 RUN 编译出来的文件	通过 Gradle 的 assembleDebug 或 assembleRelease 重新编译，或者 Generate Signed APK
does not contain AndroidManifest.xml	无效的 APK 文件
is not a valid zip file	无效的 APK 文件
Offline	设备未连接成功	先将设备与 adb 连接成功
unauthorized	设备未授权允许调试
error: device not found	没有连接成功的设备	先将设备与 adb 连接成功
protocol failure	设备已断开连接	先将设备与 adb 连接成功
Unknown option: -s	Android 2.2 以下不支持安装到 sdcard	不使用 -s 参数
No space left on device	空间不足	清理空间
Permission denied … sdcard …	sdcard 不可用
signatures do not match the previously installed version; ignoring!	已安装该应用且签名不一致	先卸载设备上的该应用，再安装

参考：PackageManager.java adb install 实际是分三步完成：

push apk 文件到 /data/local/tmp。
调用 pm install 安装。
删除 /data/local/tmp 下的对应 apk 文件。

4.3.3 卸载应用#

卸载应用的基本命令格式是：

1
adb uninstall [-k] <package-name>
2
1

<package-name> 表示应用的包名，-k 参数可选，表示卸载应用但保留数据和缓存目录。

4.3.4 清除应用数据与缓存#

1
adb shell pm clear <package-name>
2
1

<package-name> 表示应用名包，这条命令的效果相当于在设置里的应用信息界面点击了「清除缓存」和「清除数据」。

4.3.5 查看前台 Activity#

1
adb shell dumpsys activity activities | grep mFocusedActivity
2
1

4.3.6 查看正在运行的 Services#

1
adb shell dumpsys activity services [<package-name>]
2
1

<package-name> 参数不是必须的，指定 <package-name> 表示查看与某个包名相关的 Services，不指定表示查看所有 Services。<package-name> 不一定要给出完整的包名，可以只给一部分，那么所给包名相关的 Services 都会列出来。

4.3.7 查看应用详细信息#

1
adb shell dumpsys package <package-name>
2
1

<package-name> 表示应用包名。运行次命令的输出中包含很多信息，包括 Activity Resolver Table、Registered ContentProviders、包名、userId、安装后的文件资源代码等路径、版本信息、权限信息和授予状态、签名版本信息等。

4.3.7 查看应用安装路径#

1
adb shell pm path <package-name>
2
1

4.4 与应用交互#

与应用交互主要是使用 am <command> 命令，常用的 <command> 如下：

command	用途
`start [options] <intent>`	启动 `<intent>` 指定的 Activity
`startservice [options] <intent>`	启动 `<intent>` 指定的 Service
`broadcast [options] <intent>`	发送 `<intent>` 指定的广播
`force-stop <package-name>`	停止 `<package-name>` 相关的进程

<intent> 参数很灵活，和写 Android 程序时代码里的 Intent 相对应。用于决定 intent 对象的选项如下：

参数	含义
`-a <action>`	指定 action，比如 android.intent.action.VIEW
`-c <category>`	指定 category，比如 android.intent.category.APP_CONTACTS
`-n <component>`	指定完整 component 名，用于明确指定启动哪个 Activity

<intent> 里还能带数据，就像写代码时的 Bundle 一样：

参数	含义
`--esn <extra-key>`	null 值(只有 key 名)
`-e	—es `
`--ez <extra-key> <extra-boolean-value>`	boolean 值
`--ei <extra-key> <extra-int-value>`	integer 值
`--el <extra-key> <extra-long-value>`	long 值
`--ef <extra-key> <extra-float-value>`	float 值
`--eu <extra-key> <extra-uri-value>`	URI
`--ecn <extra-key> <extra-component-name-value>`	component name
`--eia <extra-key> <extra-int-value>[,<extra-int-value...]`	integer 数组
`--ela <extra-key> <extra-long-value>[,<extra-long-value...]`	long 数组

4.4.1 启动应用/ 调起 Activity#

1
adb shell am start [options] <intent>
2
1

例如：

1
adb shell am start -a android.settings.SETTINGS                   # 打开系统设置页面
2
adb shell am start -a android.intent.action.DIAL -d tel:10086     # 打开拨号页面
3
adb shell am start -n com.android.mms/.ui.ConversationList        # 打开短信会话列表
4
123

options 是一些改变其行为的选项，支持的可选参数及含义如下：

选项	含义
-D	启用调试
-W	等待启动完成
–start-profiler file	启动分析器并将结果发送到 file
-P file	类似于 —start-profiler，但当应用进入空闲状态时分析停止
-R count	重复 Activity 启动次数
-S	启动 Activity 前强行停止目标应用
–opengl-trace	启用 OpenGL 函数的跟踪
–user user_id	current

4.4.2 调起 Service#

1
adb shell am startservice [options] <intent>
2
1

一个典型的用例是如果设备上原本应该显示虚拟按键但是没有显示，可以试试这个：

1
adb shell am startservice -n com.android.systemui/.SystemUIService
2
1

4.4.3 停止 Service#

1
adb shell am stopservice [options] <intent>
2
1

4.4.4 发送广播#

1
adb shell am broadcast [options] <INTENT>
2
1

可以向所有组件广播，也可以只向指定组件广播。例如，向所有组件广播 BOOT_COMPLETED：

1
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED
2
1

又例如，只向 com.android.receiver.test/.BootCompletedReceiver 广播 BOOT_COMPLETED：

1
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED -n com.android.receiver.test/.BootCompletedReceiver
2
1

这类用法在测试的时候很实用，比如某个广播的场景很难制造，可以考虑通过这种方式来发送广播。既能发送系统预定义的广播，也能发送自定义广播。如下是部分系统预定义广播及正常触发时机：

action	触发时机
android.net.conn.CONNECTIVITY_CHANGE	网络连接发生变化
android.intent.action.SCREEN_ON	屏幕点亮
android.intent.action.SCREEN_OFF	屏幕熄灭
android.intent.action.BATTERY_LOW	电量低，会弹出电量低提示框
android.intent.action.BATTERY_OKAY	电量恢复了
android.intent.action.BOOT_COMPLETED	设备启动完毕
android.intent.action.DEVICE_STORAGE_LOW	存储空间过低
android.intent.action.DEVICE_STORAGE_OK	存储空间恢复
android.intent.action.PACKAGE_ADDED	安装了新的应用
android.net.wifi.STATE_CHANGE	WiFi连接状态发生变化
android.net.wifi.WIFI_STATE_CHANGED	WiFi状态变为启用/关闭/正在启动/正在关闭/未知
android.intent.action.BATTERY_CHANGED	电池电量发生变化
android.intent.action.INPUT_METHOD_CHANGED	系统输入法发生变化
android.intent.action.ACTION_POWER_CONNECTED	外部电源连接
android.intent.action.ACTION_POWER_DISCONNECTED	外部电源断开连接
android.intent.action.DREAMING_STARTED	系统开始休眠
android.intent.action.DREAMING_STOPPED	系统停止休眠
android.intent.action.WALLPAPER_CHANGED	壁纸发生变化
android.intent.action.HEADSET_PLUG	插入耳机
android.intent.action.MEDIA_UNMOUNTED	卸载外部介质
android.intent.action.MEDIA_MOUNTED	挂载外部介质
android.os.action.POWER_SAVE_MODE_CHANGED	省电模式开启

（以上广播均可使用 adb 触发）

4.4.5 强制停止应用#

1
adb shell am force-stop <packagename>
2
1

4.4.6 收紧内存#

1
adb shell am send-trim-memory  <pid> <level>
2
1

参数说明：

pid: 进程 ID
level、RUNNING_MODERATE、BACKGROUND、RUNNING_LOW、MODERATE、RUNNING_CRITICAL、COMPLETE

4.5 文件管理#

4.5.1 从模拟器/设备下载指定的文件到计算机#

从模拟器/设备下载指定的文件到计算机的基本命令格式是：

1
adb pull <remote> [local]
2
1

参数说明：

remote: 模拟器/设备里的文件路径
local:计算机上的目录，参数可以省略，默认复制到当前目录

例如，将 /sdcard/music.mp4 下载到计算机的当前目录：

1
adb pull /sdcard/music.mp4
2
1

将 /sdcard/music.mp4 下载到计算机的当前目录(目录需存在)：

adb pull /sdcard/music.mp4 D:\Download

4.5.2 将指定的文件从计算机上传到模拟器/设备#

将指定的文件从计算机上传到模拟器/设备的基本命令格式是：

1
adb push <local> <remote>
2
1

参数说明：

local:计算机上的文件路径
remote: 模拟器/设备里的目录

例如，将 D:\Download\music.mp4 下载到设备的/sdcard/music/目录：

1
adb push D:\Download\music.mp4 /sdcard/music/
2
1

4.5.4 列出指定目录的内容#

列出模拟器/设备上指定目录的内容的基本命令格式是：

1
adb shell ls [options] <directory>
2
1

<directory> 表示指定目录，可以省略，表示列出根目录下的所有文件和目录。 adb shell ls 后面可以跟一些可选参数进行过滤查看不同的列表，可用参数及含义如下：

参数	显示列表
无	列出目录下的所有文件和目录
-a	列出目录下的所有文件(包括隐藏的)
-i	列出目录下的所有文件和索引编号
-s	列出目录下的所有文件和文件大小
-n	列出目录下的所有文件及其 UID和 GID
-R	列出目录下的所有子目录中的文件

4.5.5 切换到目标目录#

1
adb shell cd <directory>
2
1

第一步：执行adb shell命令；第二步：执行cd <directory>命令切换到目标目录。

4.5.6 删除文件或目录#

1
adb shell rm [options] <files or directory>
2
1

第一步：执行adb shell命令；第二步：执行rm [options] <files or directory>命令删除文件或目录。 rm 后面可以跟一些可选参数进行不同的操作，可用参数及含义如下：

参数	含义
无	删除文件
-f	强制删除文件，系统不提示
-r	强制删除指定目录中的所有文件和子目录
-d	删除指定目录，即使它是一个非空目录
-i	交互式删除，删除前提示

rm -d 等同于 rmdir 命令，有些版本不包含-d 参数。

4.5.7 创建目录#

1
adb shell mkdir [options] <directory-name>
2
1

第一步：执行adb shell命令；第二步：执行mkdir [options] <directory-name>命令创建目录。 mkdir 后面可以跟一些可选参数进行不同的操作，可用参数及含义如下：

参数	含义
无	创建指定目录
-m	创建指定目录并赋予读写权限
-p	创建指定目录及其父目录

4.5.8 创建空文件或改变文件时间戳#

1
adb shell touch [options] <file>
2
1

第一步：执行adb shell命令；第二步：执行touch [options] <file>命令创建空文件或改变文件时间戳。可通过ls -n <directory> 命令查看文件的时间。

4.5.9 输出当前目录路径#

1
adb shell pwd
2
1

第一步：执行adb shell命令；第二步：执行pwd命令输出当前目录路径。

4.5.10 复制文件和目录#

1
adb shell cp [options] <source> <dest>
2
1

第一步：执行adb shell命令；第二步：执行cp [options] <source> <dest>命令复制文件和目录。参数说明：

source:源文件路径
dest: 目标文件路径

4.5.11 移动或重命名文件#

1
adb shell mv [options] <source> <dest>
2
1

第一步：执行adb shell命令；第二步：执行mv [options] <source> <dest>命令移动或重命名文件。参数说明：

source:源文件路径
dest: 目标文件路径

4.6 网络管理#

4.6.1 查看网络统计信息#

1
adb shell netstat
2
1

也可以将网络统计信息输出到指定文件：

1
adb shell netstat><file-path>
2
1

例如，可以通过 adb shell netstat>D:\netstat.log 将日志输出到 D:\netstat.log 中。

4.6.2 测试两个网络间的连接和延迟#

ping 命令的格式如下：

1
adb shell ping [-aAbBdDfhLnOqrRUvV] [-c count] [-i interval] [-I interface]
2
[-m mark] [-M pmtudisc_option] [-l preload] [-p pattern] [-Q tos]
3
[-s packetsize] [-S sndbuf] [-t ttl] [-T timestamp_option]
4
[-w deadline] [-W timeout] [hop1 ...] destination
5
1234

例如，ping一个域名：

1
adb shell ping www.google.com
2
1

不结束的话会一直ping下去，可以按 Ctrl + C 停止ping操作。也可以指定ping的次数：

1
adb shell ping -c 4 www.google.com
2
1

4.6.3 通过配置文件配置和管理网络连接#

netcfg 命令的格式如下：

1
adb shell netcfg [<interface> {dhcp|up|down}]
2
1

输出示例：

1
rmnet_ims10 DOWN                                   0.0.0.0/0   0x00001002
2
rmnet_ims00 DOWN                                   0.0.0.0/0   0x00001002
3
rmnet_tun04 DOWN                                   0.0.0.0/0   0x00001002
4
rmnet_tun03 DOWN                                   0.0.0.0/0   0x00001002
5
rmnet_tun02 DOWN                                   0.0.0.0/0   0x00001002
6
rmnet_tun01 DOWN                                   0.0.0.0/0   0x00001002
7
rmnet_tun00 DOWN                                   0.0.0.0/0   0x00001002
8
rmnet_tun14 DOWN                                   0.0.0.0/0   0x00001002
9
rmnet_tun13 DOWN                                   0.0.0.0/0   0x00001002
10
rmnet_tun12 DOWN                                   0.0.0.0/0   0x00001002
11
rmnet_tun11 DOWN                                   0.0.0.0/0   0x00001002
12
rmnet_tun10 DOWN                                   0.0.0.0/0   0x00001002
13
rmnet1   DOWN                                   0.0.0.0/0   0x00001002
14
rmnet0   DOWN                                   0.0.0.0/0   0x00001002
15
rmnet4   DOWN                                   0.0.0.0/0   0x00001002
16
rmnet3   DOWN                                   0.0.0.0/0   0x00001002
17
rmnet2   DOWN                                   0.0.0.0/0   0x00001002
18
rmnet6   DOWN                                   0.0.0.0/0   0x00001002
19
rmnet5   DOWN                                   0.0.0.0/0   0x00001002
20
dummy0   UP                                     0.0.0.0/0   0x000000c3
21
rmnet_r_ims10 DOWN                                   0.0.0.0/0   0x00001002
22
rmnet_r_ims00 DOWN                                   0.0.0.0/0   0x00001002
23
rmnet_emc0 DOWN                                   0.0.0.0/0   0x00001002
24
lo       UP                                   127.0.0.1/8   0x00000049
25
sit0     DOWN                                   0.0.0.0/0   0x00000080
26
wlan0    UP                                 10.0.38.176/23  0x00001043
27
1234567891011121314151617181920212223242526

展开收起

4.6.4 显示、操作路由、设备、策略路由和隧道#

ip 命令的格式如下：

1
adb shell ip [ options ] object
2
1

options := { -V[ersion] | -s[tatistics] | -d[etails] | -r[esolve] |-f[amily] { inet | inet6 | ipx | dnet | link } |-l[oops] { maximum-addr-flush-attempts } |-o[neline] | -t[imestamp] | -b[atch] [filename] |-rc[vbuf] [size]}
object := { link | addr | addrlabel | route | rule | neigh | ntable |tunnel | tuntap | maddr | mroute | mrule | monitor | xfrm |netns | l2tp }

options 是一些修改ip行为或者改变其输出的选项。所有的选项都是以-字符开头，分为长、短两种形式，支持的可选参数及含义如下：

选项	含义
-V,-Version	打印ip的版本并退出
-s,-stats,-statistics	输出更为详尽的信息(如果这个选项出现两次或者多次，输出的信息将更为详尽)
-f,-family	强调使用的协议种类(包括：inet、inet6或者link)
-4	是-family inet的简写
-6	是-family inet6的简写
-0	是-family link的简写
-o,-oneline	对每行记录都使用单行输出，回行用字符代替
-r,-resolve	查询域名解析系统，用获得的主机名代替主机IP地址

object 是你要管理或者获取信息的对象。目前ip认识的对象包括：

参数	显示列表
link	网络设备
address	一个设备的协议(IP或者IPV6)地址
neighbour	ARP或者NDISC缓冲区条目
route	路由表条目
rule	路由策略数据库中的规则
maddress	多播地址
mroute	多播路由缓冲区条目
tuntap	管理 TUN/TAP 设备
netns	管理网络空间

例如，查看 WiFi IP 地址：

1
adb shell ip -f inet addr show wlan0
2
1

4.7 模拟按键/输入#

在 adb shell 里有个很实用的命令叫 input，通过它可以做一些有趣的事情。可以执行adb shell input命令查看完整 help 信息如下：

1
Usage: input [<source>] <command> [<arg>...]
2

3
The sources are:
4
      dpad
5
      keyboard
6
      mouse
7
      touchpad
8
      gamepad
9
      touchnavigation
10
      joystick
11
      touchscreen
12
      stylus
13
      trackball
14

15
The commands and default sources are:
16

17
  text <string> (Default: touchscreen)
18
  keyevent [--longpress] <key code number or name> ... (Default: keyboard)
19
  tap <x> <y> (Default: touchscreen)
20
  swipe <x1> <y1> <x2> <y2> [duration(ms)] (Default: touchscreen)
21
  draganddrop <x1> <y1> <x2> <y2> [duration(ms)] (Default: touchscreen)
22
  press (Default: trackball)
23
  roll <dx> <dy> (Default: trackball)
24
1234567891011121314151617181920212223

展开收起

比如使用 adb shell input keyevent <keycode> 命令，不同的 keycode 能实现不同的功能，完整的 keycode 列表详见 KeyEvent，摘引部分我觉得有意思的如下：

keycode	含义
3	HOME 键
4	返回键
5	打开拨号应用
6	挂断电话
24	增加音量
25	降低音量
26	电源键
27	拍照（需要在相机应用里）
64	打开浏览器
82	菜单键
85	播放/暂停
86	停止播放
87	播放下一首
88	播放上一首
122	移动光标到行首或列表顶部
123	移动光标到行末或列表底部
126	恢复播放
127	暂停播放
164	静音
176	打开系统设置
187	切换应用
207	打开联系人
208	打开日历
209	打开音乐
210	打开计算器
220	降低屏幕亮度
221	提高屏幕亮度
223	系统休眠
224	点亮屏幕
231	打开语音助手
276	如果没有 wakelock 则让系统休眠

下面是 input 命令的一些用法举例。

4.7.1 电源键#

1
adb shell input keyevent 26
2
1

执行效果相当于按电源键。

4.7.2 菜单键#

1
adb shell input keyevent 82
2
1

4.7.3 HOME 键#

1
adb shell input keyevent 3
2
1

4.7.4 返回键#

1
adb shell input keyevent 4
2
1

4.7.5 音量控制#

增加音量：

1
adb shell input keyevent 24
2
1

降低音量：

1
adb shell input keyevent 25
2
1

静音：

1
adb shell input keyevent 164
2
1

4.7.6 媒体控制#

播放/暂停：

1
adb shell input keyevent 85
2
1

停止播放：

1
adb shell input keyevent 86
2
1

播放下一首：

1
adb shell input keyevent 87
2
1

播放上一首：

1
adb shell input keyevent 88
2
1

恢复播放：

1
adb shell input keyevent 126
2
1

暂停播放：

1
adb shell input keyevent 127
2
1

4.7.7 点亮/熄灭屏幕#

点亮屏幕：

1
adb shell input keyevent 224
2
1

熄灭屏幕：

1
adb shell input keyevent 223
2
1

4.7.8 滑动解锁#

如果锁屏没有密码，是通过滑动手势解锁，那么可以通过 input swipe 来解锁。命令（参数以机型 Nexus 5，向上滑动手势解锁举例）：

1
adb shell input swipe 300 1000 300 500
2
1

参数 300 1000 300 500 分别表示起始点x坐标起始点y坐标结束点x坐标结束点y坐标。

4.7.9 输入文本#

在焦点处于某文本框时，可以通过 input 命令来输入文本。

1
adb shell input text hello
2
1

4.8 日志打印#

Android 系统的日志分为两部分，底层的 Linux 内核日志输出到 /proc/kmsg，Android 的日志输出到 /dev/log。

4.8.1 Android 日志#

查看 Android 设备系统属性的基本命令格式是：

1
adb logcat [option] [filter-specs]
2
1

如果需要停止 logcat 日志打印，可以按 Ctrl + C 停止日志监控。

4.8.1.1 按级别过滤日志#

按级别过滤日志的基本命令格式是：

1
adb logcat [filter-specs]
2
1

Android 的日志分为如下几个优先级（priority）：

级别	含义
*	过滤只显示 Verbose 及以上级别(优先级最低)
*:`D`	过滤只显示 Debug 及以上级别
*	过滤只显示 Info 及以上级别
*	过滤只显示 Warning 及以上级别
*	过滤只显示 Error 及以上级别
*	过滤只显示 Fatal 及以上级别
*	过滤只显示 Silent 及以上级别(优先级最高，什么也不输出)

按某级别过滤日志则会将该级别及以上的日志输出。比如，命令：

1
adb logcat *:W
2
1

会将 Warning、Error、Fatal 和 Silent 日志输出。（注：在 macOS 下需要给 * 这样以 * 作为 tag 的参数加双引号，如 adb logcat "*:W"，不然会报错 no matches found: *:W。）

4.8.1.2 按 tag 和级别过滤日志#

按 tag 和级别过滤日志的基本命令格式是：

1
adb logcat [tag:level] [tag:level] ...
2
1

比如，命令：

1
adb logcat ActivityManager:I MyApp:D *:S
2
1

表示输出 tag ActivityManager 的 Info 以上级别日志，输出 tag MyApp 的 Debug 以上级别日志，及其它 tag 的 Silent 级别日志（即屏蔽其它 tag 日志）。

4.8.1.3 将日志格式化输出#

可以用 adb logcat -v <format> 选项指定日志输出格式。日志支持按以下几种 <format>：

参数	显示格式
brief	`<priority>/<tag>(<pid>): <message>`
process	`<priority>(<pid>) <message>`
tag	`<priority>/<tag>: <message>`
raw	`<message>`
time	`<datetime> <priority>/<tag>(<pid>): <message>`
threadtime	`<datetime> <pid> <tid> <priority> <tag>: <message>`
long	`[ <datetime> <pid>:<tid> <priority>/<tag> ] <message>`

日志格式默认为 brief，指定格式可与上面的过滤同时使用。比如：

1
adb logcat -v long ActivityManager:I *:S
2
1

4.8.1.3 清空已存在的日志#

1
adb logcat -c
2
1

4.8.1.4 将日志显示在控制台#

1
adb logcat -d
2
1

4.8.1.5 将日志输出到文件#

1
adb logcat -f <file-path>
2
1

4.8.1.6 加载一个可使用的日志缓冲区供查看#

1
adb logcat -b <Buffer>
2
1

Android log 输出量巨大，特别是通信系统的log，因此，Android把log输出到不同的缓冲区中，目前定义了四个log缓冲区：

缓冲区	含义
Radio	输出通信系统的 log
System	输出系统组件的 log
Event	输出 event 模块的 log
Main	所有 java 层的 log 以及不属于上面3层的 log

缓冲区主要给系统组件使用，一般的应用不需要关心，应用的log都输出到main缓冲区中。默认log输出（不指定缓冲区的情况下）是输出System和Main缓冲区的log。

4.8.1.7 打印指定日志缓冲区的大小#

1
adb logcat -g
2
1

4.8.2 内核日志#

1
adb shell dmesg
2
1

输出示例：

1
<6>[14201.684016] PM: noirq resume of devices complete after 0.982 msecs
2
<6>[14201.685525] PM: early resume of devices complete after 0.838 msecs
3
<6>[14201.753642] PM: resume of devices complete after 68.106 msecs
4
<4>[14201.755954] Restarting tasks ... done.
5
<6>[14201.771229] PM: suspend exit 2016-08-28 13:31:32.679217193 UTC
6
<6>[14201.872373] PM: suspend entry 2016-08-28 13:31:32.780363596 UTC
7
<6>[14201.872498] PM: Syncing filesystems ... done.
8
1234567

中括号里的 [14201.684016] 代表内核开始启动后的时间，单位为秒。通过内核日志我们可以做一些事情，比如衡量内核启动时间，在系统启动完毕后的内核日志里找到 Freeing init memory 那一行前面的时间就是。

4.9 查看 Android 设备系统属性#

查看 Android 设备系统属性的基本命令格式是：

1
adb shell getprop [options]
2
1

除了可以查看 Android 设备系统属性之外，还可以设置系统属性，设置系统属性的基本命令格式是：

1
adb shell setprop <key> <value>
2
1

4.9.1 查看设备型号#

1
adb shell getprop ro.product.model
2
1

输出示例：

1
Nexus 5
2
1

4.9.2 查看设备电池状况#

1
adb shell dumpsys battery
2
1

输出示例：

1
Current Battery Service state:
2
  AC powered: false
3
  USB powered: true
4
  Wireless powered: false
5
  status: 2
6
  health: 2
7
  present: true
8
  level: 44
9
  scale: 100
10
  voltage: 3872
11
  temperature: 280
12
  technology: Li-poly
13
123456789101112

其中 scale 代表最大电量，level 代表当前电量。上面的输出表示还剩下 44% 的电量。

4.9.3 查看设备屏幕分辨率#

1
adb shell wm size
2
1

输出示例：

1
Physical size: 1080x1920
2
1

该设备屏幕分辨率为 1080px * 1920px。如果使用命令修改过，那输出可能是：

1
Physical size: 1080x1920
2
Override size: 480x1024
3
12

表明设备的屏幕分辨率原本是 1080px * 1920px，当前被修改为 480px * 1024px。

4.9.4 查看设备屏幕密度#

1
adb shell wm density
2
1

输出示例：

1
Physical density: 420
2
1

该设备屏幕密度为 420dpi。如果使用命令修改过，那输出可能是：

1
Physical density: 480
2
Override density: 160
3
12

表明设备的屏幕密度原来是 480dpi，当前被修改为 160dpi。

4.9.5 查看设备显示屏参数#

1
adb shell dumpsys window displays
2
1

输出示例：

1
WINDOW MANAGER DISPLAY CONTENTS (dumpsys window displays)
2
  Display: mDisplayId=0
3
    init=1080x1920 420dpi cur=1080x1920 app=1080x1794 rng=1080x1017-1810x1731
4
    deferred=false layoutNeeded=false
5
1234

其中 mDisplayId 为显示屏编号，init 是初始分辨率和屏幕密度，app 的高度比 init 里的要小，表示屏幕底部有虚拟按键，高度为 1920 - 1794 = 126px 合 42dp。

4.9.6 查看设备 android_id#

1
adb shell settings get secure android_id
2
1

输出示例：

1
51b6be48bac8c569
2
1

4.9.7 查看设备IMEI#

在 Android 4.4 及以下版本可通过如下命令获取 IMEI：

1
adb shell dumpsys iphonesubinfo
2
1

输出示例：

1
Phone Subscriber Info:
2
  Phone Type = GSM
3
  Device ID = 860955027785041
4
123

其中的 Device ID 就是 IMEI。而在 Android 5.0 及以上版本里这个命令输出为空，得通过其它方式获取了（需要 root 权限）：

1
adb shell
2
su
3
service call iphonesubinfo 1
4
123

把里面的有效内容提取出来就是 IMEI 了，比如这里的是 860955027785041。参考：adb shell dumpsys iphonesubinfo not working since Android 5.0 Lollipop

4.9.8 查看设备 Android 系统版本#

1
adb shell getprop ro.build.version.release
2
1

输出示例：

4.9.9 查看设备 IP 地址#

1
adb shell ifconfig | grep Mask
2
1

在有的设备上这个命令没有输出，如果设备连着 WiFi，可以使用如下命令来查看局域网 IP：

1
adb shell ifconfig wlan0
2
1

如果以上命令仍然不能得到期望的信息，那可以试试以下命令（部分系统版本里可用）：

1
adb shell netcfg
2
1

4.9.10 查看设备 Mac 地址#

1
adb shell cat /sys/class/net/wlan0/address
2
1

输出示例：

1
f8:a9:d0:17:42:4d
2
1

这查看的是局域网 Mac 地址，移动网络或其它连接的信息可以通过前面的小节「IP 地址」里提到的 adb shell netcfg 命令来查看。

4.9.11 查看设备 CPU 信息#

1
adb shell cat /proc/cpuinfo
2
1

4.9.12 查看设备内存信息#

1
adb shell cat /proc/meminfo
2
1

4.9.13 查看设备更多硬件与系统属性#

设备的更多硬件与系统属性可以通过如下命令查看：

1
adb shell cat /system/build.prop
2
1

这会输出很多信息，包括前面几个小节提到的「型号」和「Android 系统版本」等。输出里还包括一些其它有用的信息，它们也可通过 adb shell getprop <属性名> 命令单独查看，列举一部分属性如下：

属性名	含义
ro.build.version.sdk	SDK 版本
ro.build.version.release	Android 系统版本
ro.build.version.security_patch	Android 安全补丁程序级别
ro.product.model	型号
ro.product.brand	品牌
ro.product.name	设备名
ro.product.board	处理器型号
ro.product.cpu.abilist	CPU 支持的 abi 列表[节注一]
persist.sys.isUsbOtgEnabled	是否支持 OTG
dalvik.vm.heapsize	每个应用程序的内存上限
ro.sf.lcd_density	屏幕密度

节注一：一些小厂定制的 ROM 可能修改过 CPU 支持的 abi 列表的属性名，如果用 ro.product.cpu.abilist 属性名查找不到，可以这样试试：

1
adb shell cat /system/build.prop | grep ro.product.cpu.abi
2
1

示例输出：

1
ro.product.cpu.abi=armeabi-v7a
2
ro.product.cpu.abi2=armeabi
3
12

4.10 修改设置#

注：修改设置之后，运行恢复命令有可能显示仍然不太正常，可以运行 adb reboot 重启设备，或手动重启。修改设置的原理主要是通过 settings 命令修改 /data/data/com.android.providers.settings/databases/settings.db 里存放的设置值。

4.10.1 修改分辨率#

1
adb shell wm size 480x1024
2
1

表示将分辨率修改为 480px * 1024px。恢复原分辨率命令：

1
adb shell wm size reset
2
1

4.10.2 修改屏幕密度#

1
adb shell wm density 160
2
1

表示将屏幕密度修改为 160dpi。恢复原屏幕密度命令：

1
adb shell wm density reset
2
1

4.10.3 修改显示区域#

1
adb shell wm overscan 0,0,0,200
2
1

四个数字分别表示距离左、上、右、下边缘的留白像素，以上命令表示将屏幕底部 200px 留白。恢复原显示区域命令：

1
adb shell wm overscan reset
2
1

4.10.4 修改关闭 USB 调试模式#

1
adb shell settings put global adb_enabled 0
2
1

用命令恢复不了了，毕竟关闭了 USB 调试 adb 就连接不上 Android 设备了。去设备上手动恢复吧：「设置」-「开发者选项」-「Android 调试」。

4.10.5 修改允许/禁止访问非 SDK API#

允许访问非 SDK API：

1
adb shell settings put global hidden_api_policy_pre_p_apps 1
2
adb shell settings put global hidden_api_policy_p_apps 1
3
12

禁止访问非 SDK API：

1
adb shell settings delete global hidden_api_policy_pre_p_apps
2
adb shell settings delete global hidden_api_policy_p_apps
3
12

不需要设备获得 Root 权限。命令最后的数字的含义：

值	含义
0	禁止检测非 SDK 接口的调用。该情况下，日志记录功能被禁用，并且令 strict mode API，即 detectNonSdkApiUsage() 无效。不推荐。
1	仅警告——允许访问所有非 SDK 接口，但保留日志中的警告信息，可继续使用 strick mode API。
2	禁止调用深灰名单和黑名单中的接口。
3	禁止调用黑名单中的接口，但允许调用深灰名单中的接口。

4.10.6 修改状态栏和导航栏的显示隐藏#

1
adb shell settings put global policy_control <key-values>
2
1

<key-values> 可由如下几种键及其对应的值组成，格式为 <key1>=<value1>:<key2>=<value2>。

key	含义
immersive.full	同时隐藏
immersive.status	隐藏状态栏
immersive.navigation	隐藏导航栏
immersive.preconfirms	?

这些键对应的值可则如下值用逗号组合：

value	含义
apps	所有应用
*	所有界面
package-name	指定应用
-package-name	排除指定应用

例如：

1
adb shell settings put global policy_control immersive.full=*
2
1

表示设置在所有界面下都同时隐藏状态栏和导航栏。

1
adb shell settings put global policy_control immersive.status=com.package1,com.package2:immersive.navigation=apps,-com.package3
2
1

表示设置在包名为 com.package1 和 com.package2 的应用里隐藏状态栏，在除了包名为 com.package3 的所有应用里隐藏导航栏。

4.11 实用功能#

4.11.1 屏幕截图#

截图保存到电脑：

1
adb exec-out screencap -p > sc.png
2
1

如果 adb 版本较老，无法使用 exec-out 命令，这时候建议更新 adb 版本。无法更新的话可以使用以下麻烦点的办法：先截图保存到设备里：

1
adb shell screencap -p /sdcard/sc.png
2
1

然后将 png 文件导出到电脑：

1
adb pull /sdcard/sc.png
2
1

可以使用 adb shell screencap -h 查看 screencap 命令的帮助信息，下面是两个有意义的参数及含义：

参数	含义
-p	指定保存文件为 png 格式
-d display-id	指定截图的显示屏编号（有多显示屏的情况下）

实测如果指定文件名以 .png 结尾时可以省略 -p 参数；否则需要使用 -p 参数。如果不指定文件名，截图文件的内容将直接输出到 stdout。另外一种一行命令截图并保存到电脑的方法： Linux 和 Windows

1
adb shell screencap -p | sed "s/\r$//" > sc.png
2
1

Mac OS X

1
adb shell screencap -p | gsed "s/\r$//" > sc.png
2
1

这个方法需要用到 gnu sed 命令，在 Linux 下直接就有，在 Windows 下 Git 安装目录的 bin 文件夹下也有。如果确实找不到该命令，可以下载 sed for Windows 并将 sed.exe 所在文件夹添加到 PATH 环境变量里。而在 Mac 下使用系统自带的 sed 命令会报错：

1
sed: RE error: illegal byte sequence
2
1

需要安装 gnu-sed，然后使用 gsed 命令：

1
brew install gnu-sed
2
1

4.11.2 录制屏幕#

录制屏幕以 mp4 格式保存到 /sdcard：

1
adb shell screenrecord /sdcard/filename.mp4
2
1

需要停止时按 Ctrl-C，默认录制时间和最长录制时间都是 180 秒。如果需要导出到电脑：

1
adb pull /sdcard/filename.mp4
2
1

可以使用 adb shell screenrecord --help 查看 screenrecord 命令的帮助信息，下面是常见参数及含义：

参数	含义
–size WIDTHxHEIGHT	视频的尺寸，比如 1280x720，默认是屏幕分辨率。
–bit-rate RATE	视频的比特率，默认是 4Mbps。
–time-limit TIME	录制时长，单位秒。
–verbose	输出更多信息。

4.11.3 查看连接过的 WiFi 密码#

注：需要 root 权限。

1
adb shell
2
su
3
cat /data/misc/wifi/*.conf
4
123

4.11.4 设置系统日期和时间#

注：需要 root 权限。

1
adb shell
2
su
3
date -s 20160823.131500
4
123

表示将系统日期和时间更改为 2016 年 08 月 23 日 13 点 15 分 00 秒。

4.11.5 重启手机#

1
adb reboot
2
1

4.11.6 检测设备是否已 root#

1
adb shell
2
su
3
12

此时命令行提示符是 $ 则表示没有 root 权限，是 # 则表示已 root。

4.11.7 使用 Monkey 进行压力测试#

Monkey 可以生成伪随机用户事件来模拟单击、触摸、手势等操作，可以对正在开发中的程序进行随机压力测试。简单用法：

1
adb shell monkey -p <packagename> -v 500
2
1

表示向 <packagename> 指定的应用程序发送 500 个伪随机事件。 Monkey 的详细用法参考官方文档。

4.11.8 开启/关闭 WiFi#

注：需要 root 权限。开启 WiFi：

1
adb root
2
adb shell svc wifi enable
3
12

关闭 WiFi：

1
adb root
2
adb shell svc wifi disable
3
12

若执行成功，输出为空；若未取得 root 权限执行此命令，将执行失败，输出 Killed。

4.12 刷机相关命令#

4.12.1 重启到 Recovery 模式#

1
adb reboot recovery
2
1

4.12.2 从 Recovery 重启到 Android#

1
adb reboot
2
1

4.12.3 重启到 Fastboot 模式#

1
adb reboot bootloader
2
1

4.12.4 通过 sideload 更新系统#

如果我们下载了 Android 设备对应的系统更新包到电脑上，那么也可以通过 adb 来完成更新。以 Recovery 模式下更新为例：

重启到 Recovery 模式。

adb reboot recovery
在设备的 Recovery 界面上操作进入 Apply update-Apply from ADB。注：不同的 Recovery 菜单可能与此有差异，有的是一级菜单就有 Apply update from ADB。
通过 adb 上传和更新系统。

adb sideload <path-to-update.zip>

4.13 安全相关命令#

4.13.1 启用/禁用 SELinux#

启用 SELinux

1
adb root
2
adb shell setenforce 1
3
12

禁用 SELinux

1
adb root
2
adb shell setenforce 0
3
12

4.13.2 启用/禁用 dm_verity#

启用 dm_verity

1
adb root
2
adb enable-verity
3
12

禁用 dm_verity

1
adb root
2
adb disable-verity
3
12

4.14 更多 adb shell 命令#

Android 系统是基于 Linux 内核的，所以 Linux 里的很多命令在 Android 里也有相同或类似的实现，在 adb shell 里可以调用。本文档前面的部分内容已经用到了 adb shell 命令。

4.14.1 查看进程状态#

1
adb shell ps
2
1

输出信息各列含义：

列名	含义
USER	所属用户
PID	进程 ID
PPID	父进程 ID
NAME	进程名

4.14.2 查看处理器实时状态#

1
adb shell top [-m max_procs] [-n iterations] [-d delay] [-s sort_column] [-t] [-h]
2
1

adb shell top 后面可以跟一些可选参数进行过滤查看不同的列表，可用参数及含义如下：

参数	含义
-m	最多显示多少个进程
-n	刷新多少次后退出
-d	刷新时间间隔(单位秒，默认值5)
-s	按某列排序(可用col值：cpu, vss, rss, thr)
-t	显示线程信息
-h	显示帮助文档

输出信息各列含义：

列名	含义
PID	进程 ID
PR	优先级
CPU%	当前瞬间占用 CPU 百分比
S	进程状态（R=运行，S=睡眠，T=跟踪/停止，Z=僵尸进程）
#THR	线程数
VSS	Virtual Set Size 虚拟耗用内存（包含共享库占用的内存）
RSS	Resident Set Size 实际使用物理内存（包含共享库占用的内存）
PCY	调度策略优先级，SP_BACKGROUND/SPFOREGROUND
UID	进程所有者的用户 ID
NAME	进程名

4.14.3 查看进程 UID#

有两种方案：

adb shell dumpsys package <packagename> | grep userId= 如：

adb shell dumpsys package org.mazhuang.guanggoo | grep userId= userId=10394
通过 ps 命令找到对应进程的 pid 之后 adb shell cat /proc/<pid>/status | grep Uid如：

adb shell gemini:/ ps∣greporg.mazhuang.guanggoou0a39428635770179581278736SySepoll0000000000Sorg.mazhuang.guanggoogemini:/ps | grep org.mazhuang.guanggoo u0_a394 28635 770 1795812 78736 SyS_epoll_ 0000000000 S org.mazhuang.guanggoo gemini:/ps∣greporg.mazhuang.guanggoou0a39428635770179581278736SySepoll0000000000Sorg.mazhuang.guanggoogemini:/ cat /proc/28635/status | grep Uid Uid: 10394 10394 10394 10394 gemini:/ $

五、参考#

宝藏网址

Wed, 03 Feb 2021 03:12:37 GMT

工具类#

note.js 安装版本切换工具

https://github.com/jasongin/nvs/

缓动函数速查表

https://easings.net/cn

资源类#

它不仅提供免费的高清视频素材，还有插画，音乐，PR 模版等，相当全面

https://mixkit.co/

8000个已分类好的扁平化图标(PNG/SVG/WEBFONT)

https://www.shejidaren.com/8000-flat-icons.html

openwrt多拨笔记

Thu, 01 Aug 2019 14:12:37 GMT

公司对每个ip限速300k，平时下载文件甚至打开网页都很慢，之前斐讯0元购撸了个k2路由器，刷了openwrt，配了多拨，但是后来重新刷路由器固件后多拨配置丢了，年久未搞，配了很久都单线多拨失败。今日经过百度多篇文章，最终根据文章的图文操作，弄清楚多拨会用到哪些配置文件，特此记录下来，往后搞单线多拨只需按照笔记无脑敲命令就行了，甚至连luci都不需要。

首先更新openwrt的软件源

opkg update

然后按照必要的文件

opkg install luci kmod-macvlan luci-app-mwan3

在/etc/rc.local中exit上一行加入一下配置

sleep 6 ip link add link eth0.2 name vth1 type macvlan ifconfig vth1 up

ip link add link eth0.2 name vth2 type macvlan ifconfig vth2 up

ip link add link eth0.2 name vth3 type macvlan ifconfig vth3 up

ip link add link eth0.2 name vth4 type macvlan ifconfig vth4 up

ip link add link eth0.2 name vth5 type macvlan ifconfig vth5 up

ip link add link eth0.2 name vth6 type macvlan ifconfig vth6 up

在/etc/config/network中，把原有的config interface各项去掉，修改成一下版本： //这个wan修改一下

config interface ‘wan’
option proto ‘dhcp’
option ifname ‘eth0.2’
option metric ‘20’

config interface ‘vwan1’
option proto ‘dhcp’
option ifname ‘vth1’
option metric ‘21’

config interface ‘vwan2’
option proto ‘dhcp’
option ifname ‘vth2’
option metric ‘22’

config interface ‘vwan3’
option proto ‘dhcp’
option ifname ‘vth3’
option metric ‘23’

config interface ‘vwan4’
option proto ‘dhcp’
option ifname ‘vth4’
option metric ‘24’

config interface ‘vwan5’
option proto ‘dhcp’
option ifname ‘vth5’
option metric ‘25’

config interface ‘vwan6’
option proto ‘dhcp’
option ifname ‘vth6’
option metric ‘26’

在 /etc/config/firewall 中

config zone
option name ‘wan’
option input ‘REJECT’
option output ‘ACCEPT’
option forward ‘REJECT’
option masq ‘1’
option mtu_fix ‘1’
option network ‘wan wan6 vwan1 vwan2 vwan3 vwan4 vwan5 vwan6’

在 /etc/config/mwan3 中

config interface ‘vwan1’ option enabled ‘1’ option initial_state ‘online’ option family ‘ipv4’ option track_method ‘ping’ option reliability ‘1’ option count ‘1’ option size ‘56’ option max_ttl ‘60’ option check_quality ‘0’ option timeout ‘2’ option interval ‘5’ option failure_interval ‘5’ option recovery_interval ‘5’ option down ‘3’ option up ‘3’ list track_ip ‘8.8.8.8’

config interface ‘vwan2’ option enabled ‘1’ option initial_state ‘online’ option family ‘ipv4’ option track_method ‘ping’ option reliability ‘1’ option count ‘1’ option size ‘56’ option max_ttl ‘60’ option check_quality ‘0’ option timeout ‘2’ option interval ‘5’ option failure_interval ‘5’ option recovery_interval ‘5’ option down ‘3’ option up ‘3’ list track_ip ‘8.8.8.8’

config interface ‘vwan3’ option enabled ‘1’ option initial_state ‘online’ option family ‘ipv4’ option track_method ‘ping’ option reliability ‘1’ option count ‘1’ option size ‘56’ option max_ttl ‘60’ option check_quality ‘0’ option timeout ‘2’ option interval ‘5’ option failure_interval ‘5’ option recovery_interval ‘5’ option down ‘3’ option up ‘3’ list track_ip ‘8.8.8.8’

config interface ‘vwan4’ option enabled ‘1’ option initial_state ‘online’ option family ‘ipv4’ option track_method ‘ping’ option reliability ‘1’ option count ‘1’ option size ‘56’ option max_ttl ‘60’ option check_quality ‘0’ option timeout ‘2’ option interval ‘5’ option failure_interval ‘5’ option recovery_interval ‘5’ option down ‘3’ option up ‘3’ list track_ip ‘8.8.8.8’

config interface ‘vwan5’ option enabled ‘1’ option initial_state ‘online’ option family ‘ipv4’ option track_method ‘ping’ option reliability ‘1’ option count ‘1’ option size ‘56’ option max_ttl ‘60’ option check_quality ‘0’ option timeout ‘2’ option interval ‘5’ option failure_interval ‘5’ option recovery_interval ‘5’ option down ‘3’ option up ‘3’ list track_ip ‘8.8.8.8’

config interface ‘vwan6’ option enabled ‘1’ option initial_state ‘online’ option family ‘ipv4’ option track_method ‘ping’ option reliability ‘1’ option count ‘1’ option size ‘56’ option max_ttl ‘60’ option check_quality ‘0’ option timeout ‘2’ option interval ‘5’ option failure_interval ‘5’ option recovery_interval ‘5’ option down ‘3’ option up ‘3’ list track_ip ‘8.8.8.8’

config member ‘mwan’ option interface ‘wan’

config member ‘mvwan1’ option interface ‘vwan1’

config member ‘mvwan2’ option interface ‘vwan2’

config member ‘mvwan3’ option interface ‘vwan3’

config member ‘mvwan4’ option interface ‘vwan4’

config member ‘mvwan5’ option interface ‘vwan5’

config member ‘mvwan6’ option interface ‘vwan6’

config policy ‘balanced’ option last_resort ‘default’ list use_member ‘mwan’ list use_member ‘mvwan1’ list use_member ‘mvwan2’ list use_member ‘mvwan3’ list use_member ‘mvwan4’ list use_member ‘mvwan5’ list use_member ‘mvwan6’

最后重启一下路由器

reboot

使用大文件测速专用下载测试一下

100g http://repos.mia.lax-noc.com/speedtests/100gb.bin 10t http://repos.mia.lax-noc.com/speedtests/10tb.bin

Git 在团队中的最佳实践--如何正确使用Git Flow

Fri, 29 Mar 2019 07:56:58 GMT

Git的优点#

Git的优点很多，但是这里只列出我认为非常突出的几点。

由于是分布式，所有本地库包含了远程库的所有内容。
优秀的分支模型，打分支以及合并分支，机器方便。
快速，在这个时间就是金钱的时代，Git由于代码都在本地，打分支和合并分支机器快速，使用个SVN的能深刻体会到这种优势。

感兴趣的，可以去看一下Git本身的设计，内在的架构体现了很多的优势，不愧是出资天才程序员Linus (Linux之父) 之手

版本管理的挑战#

虽然有这么优秀的版本管理工具，但是我们面对版本管理的时候，依然有非常大得挑战，我们都知道大家工作在同一个仓库上，那么彼此的代码协作必然带来很多问题和挑战，如下：

如何开始一个Feature的开发，而不影响别的Feature？
由于很容易创建新分支，分支多了如何管理，时间久了，如何知道每个分支是干什么的？
哪些分支已经合并回了主干？
如何进行Release的管理？开始一个Release的时候如何冻结Feature, 如何在Prepare Release的时候，开发人员可以继续开发新的功能？
线上代码出Bug了，如何快速修复？而且修复的代码要包含到开发人员的分支以及下一个Release?

大部分开发人员现在使用Git就只是用三个甚至两个分支，一个是Master, 一个是Develop, 还有一个是基于Develop打得各种分支。这个在小项目规模的时候还勉强可以支撑，因为很多人做项目就只有一个Release, 但是人员一多，而且项目周期一长就会出现各种问题。

Git Flow#

就像代码需要代码规范一样，代码管理同样需要一个清晰的流程和规范

Vincent Driessen 同学为了解决这个问题提出了 A Successful Git Branching Model

下面是Git Flow的流程图

img

上面的图你理解不了？没关系，这不是你的错，我觉得这张图本身有点问题，这张图应该左转90度，大家应该就很用以理解了。

Git Flow常用的分支#

Production 分支

也就是我们经常使用的Master分支，这个分支最近发布到生产环境的代码，最近发布的Release，这个分支只能从其他分支合并，不能在这个分支直接修改

Develop 分支

这个分支是我们是我们的主开发分支，包含所有要发布到下一个Release的代码，这个主要合并与其他分支，比如Feature分支

Feature 分支

这个分支主要是用来开发一个新的功能，一旦开发完成，我们合并回Develop分支进入下一个Release

Release分支

当你需要一个发布一个新Release的时候，我们基于Develop分支创建一个Release分支，完成Release后，我们合并到Master和Develop分支

Hotfix分支

当我们在Production发现新的Bug时候，我们需要创建一个Hotfix, 完成Hotfix后，我们合并回Master和Develop分支，所以Hotfix的改动会进入下一个Release

Git Flow如何工作#

初始分支#

所有在Master分支上的Commit应该Tag

img

Feature 分支#

分支名 feature/*

Feature分支做完后，必须合并回Develop分支, 合并完分支后一般会删点这个Feature分支，但是我们也可以保留

img

Release分支#

分支名 release/*

Release分支基于Develop分支创建，打完Release分之后，我们可以在这个Release分支上测试，修改Bug等。同时，其它开发人员可以基于开发新的Feature (记住：一旦打了Release分支之后不要从Develop分支上合并新的改动到Release分支)

发布Release分支时，合并Release到Master和Develop，同时在Master分支上打个Tag记住Release版本号，然后可以删除Release分支了。

img

维护分支 Hotfix#

分支名 hotfix/*

hotfix分支基于Master分支创建，开发完后需要合并回Master和Develop分支，同时在Master上打一个tag

img

Git Flow代码示例#

a. 创建develop分支

1
git branch develop
2
git push -u origin develop

b. 开始新Feature开发

1
git checkout -b some-feature develop
2
# Optionally, push branch to origin:
3
git push -u origin some-feature
4

5
# 做一些改动
6
git status
7
git add some-file
8
git commit

c. 完成Feature

1
git pull origin develop
2
git checkout develop
3
git merge --no-ff some-feature
4
git push origin develop
5

6
git branch -d some-feature
7

8
# If you pushed branch to origin:
9
git push origin --delete some-feature

d. 开始Relase

1
git checkout -b release-0.1.0 develop
2

3
# Optional: Bump version number, commit
4
# Prepare release, commit

e. 完成Release

1
git checkout master
2
git merge --no-ff release-0.1.0
3
git push
4

5
git checkout develop
6
git merge --no-ff release-0.1.0
7
git push
8

9
git branch -d release-0.1.0
10

11
# If you pushed branch to origin:
12
git push origin --delete release-0.1.0
13

14

15
git tag -a v0.1.0 master
16
git push --tags

展开收起

f. 开始Hotfix

1
git checkout -b hotfix-0.1.1 master

g. 完成Hotfix

1
git checkout master
2
git merge --no-ff hotfix-0.1.1
3
git push
4

5

6
git checkout develop
7
git merge --no-ff hotfix-0.1.1
8
git push
9

10
git branch -d hotfix-0.1.1
11

12
git tag -a v0.1.1 master
13
git push --tags

Git flow工具#

实际上，当你理解了上面的流程后，你完全不用使用工具，但是实际上我们大部分人很多命令就是记不住呀，流程就是记不住呀，肿么办呢？

总有聪明的人创造好的工具给大家用, 那就是Git flow script.

安装#

OS X

brew install git-flow

Linux

apt-get install git-flow

Windows

wget -q -O - —no-check-certificate https://github.com/nvie/gitflow/raw/develop/contrib/gitflow-installer.sh | bash

使用#

初始化: git flow init
开始新Feature: git flow feature start MYFEATURE
Publish一个Feature(也就是push到远程): git flow feature publish MYFEATURE
获取Publish的Feature: git flow feature pull origin MYFEATURE
完成一个Feature: git flow feature finish MYFEATURE
开始一个Release: git flow release start RELEASE [BASE]
Publish一个Release: git flow release publish RELEASE
发布Release: git flow release finish RELEASE 别忘了git push —tags
开始一个Hotfix: git flow hotfix start VERSION [BASENAME]
发布一个Hotfix: git flow hotfix finish VERSION

img

Git Flow GUI#

上面讲了这么多，我知道还有人记不住，那么又有人做出了GUI 工具，你只需要点击下一步就行，工具帮你干这些事！！！

SourceTree#

当你用Git-flow初始化后，基本上你只需要点击git flow菜单选择start feature, release或者hotfix, 做完后再次选择git flow菜单，点击Done Action. 我勒个去，我实在想不到还有比这更简单的了。

目前SourceTree支持Mac, Windows, Linux.

这么好的工具请问多少钱呢？ 免费!!!!

img

转载自csdn博客，查看原文

计划进度-熟练使用docker

Thu, 14 Mar 2019 11:00:34 GMT

计划进度- 熟练使用docker#

2019.03.14 尝试使用docker搭建youphptube

笔记#

docker-compose

计划进度-熟练使用vue

Tue, 12 Mar 2019 09:39:34 GMT

计划进度- 熟练使用vue#

2019.03.12 开始阅读vue-js 2.0完全入门记录

笔记#

我的计划

Tue, 12 Mar 2019 09:21:02 GMT

花有重开日，人无再少年#

不知不觉已经2019了。成为社会人也已经有三年有余。成长了很多，但是觉得还不够。在时间管理，目标计划方面，还有很大的改进空间。经常在心里立下FLAG，但是没多久FLAG就倒了。因此本篇用于记录我的目标和计划。那些已经实现的、已经失败的、正在计划的……

已经实现的 SUCCESS✅#

OBJECT	CREATE TIME	START TIME	END TIME	CURRENT STATUS	LINK

已经失败的 FAILURE❌#

OBJECT	CREATE TIME	START TIME	END TIME	CURRENT STATUS	LINK

正在计划的 PLANNING🕛#

OBJECT	CREATE TIME	START TIME	CURRENT STATUS	LINK
熟练使用Adobe XD	2019.03.10	2019.3.13	开始阅读vue-js 2.0完全入门记录	ℹ
熟练使用 vue	2019.03.12			ℹ
熟练使用docker	2019.03.10	2019.03.14	学习搭建docker-youphptube	ℹ
熟练使用flutter	2019.03.12			ℹ

一句话笔记：相见恨晚的软件

Tue, 12 Mar 2019 09:21:02 GMT

Javassist/beanshell：Java动态编程

Everything：本地搜索

procexp：进程、窗口信息查看

typora markdown编辑器

SpaceSniffer:磁盘空间占用查看

jadx-gui:直接反编译apk成gradle工程

Cmder：Windows下命令行利器

MyWebServer：windows下简单的web服务器

pxCook: 图片标注利器，可生成代码

kindle paperwhite缺陷：WIFI问题

Thu, 06 Apr 2017 10:46:55 GMT

上午京东买了958的KPW3，结果WIFI一直连不上。于是百度解决办法，也不行。问在线客服，并没有本质上解决问题，而且技术支持一点也不懂技术。下面是对话记录。

我: 怎么看是paperwhite是第几代，连接不上wifi 您现在已连接到亚马逊的高云涛。高云涛: 您好，欢迎使用亚马逊在线服务，我是亚马逊kindle客服：高云涛，很高兴为您服务，请问有什么可以帮到您的？麻烦您提供一下设备的序列号我帮您查询下在这里查询序列号

从主页（点击小房子回到主页）点击右上角三个点菜单键。
点击【设置】，然后再次点击【右上角三点菜单键】。
点击【设备信息】.查看序列号提供一下我: ******(保护隐私，此处隐藏) 高云涛: 目前设备还没有注册是kpw3代我: 连接不上wifi 高云涛: 您连接的wifi是家庭路由器吗我: 我的手机都能连接上。是公司的路由器密码确定是正确的。百度后尝试建立WIFI_NO_NET_PROBE 文件，也不行高云涛: kindle对wifi的信道有要求的我: 改不了wifi信道，就用不了了？高云涛: 重启一下路由器试试我: 总不能每次都重启路由器吧高云涛: 重启一次，能连接上就行不用总重启或是您打开手机的流量热点我: 升级固件也不能吗？是固件的问题还是硬件的缺陷？高云涛: 连接热点注册试试目前您还没有注册，看不到固件是哪版的我: 5.8.2.1 高云涛: 太低了我: 升级了固件能够解决这个问题吗？高云涛: 系统包下载连接 http://pan.baidu.com/s/1mijs8pM • 下载系统包后，将软件更新文件传输至Kindle设备： a. 打开Kindle，并使用USB连接线将其连接至电脑。 b. 将新的更新文件从电脑拖入Kindle驱动器中。注意：不要将更新文件拖入Kindle驱动器中的任何文件夹中。 •开始软件更新： a. 在【主页】中，点击【菜单】图标，然后点击【设置】。 b. 再次点击【菜单】图标，然后点击【更新您的Kindle】。如果已安装最新更新，或者更新文件传输失败，此选项将显示为灰色。 c. 点击【确定】执行更新。此时您将看到【您的Kindle正在更新】。更新完成后，Kindle将立即自动重启。我: 我从官网下载着。高云涛: 先更新后，在试试最好也换网我: 重启路由器也不行高云涛: 换手机流量热点我: KPW3支持的信道是多少高云涛: 1.6.11 我: 不在这三个信道上的话，只能一遍遍的重启路由器？高云涛: 您现在先不用考虑那些您现在打开手机流量热点先连接试试我: 注册上了高云涛: 请问您还有其他疑问吗？我: 有，不在这三个信道上的话，只能一遍遍的重启路由器？高云涛: 可以自己设置我: 不是自己的路由器不能设置啊。。。升级固件也不能吗？是固件的问题还是硬件的缺陷？高云涛: 这个问题，建议您和公司协商一下可以连接热点，设备是没有问题的是wifi的设备问题不是通过设备更新，就能单纯解决不是同一个问题我: 不是吧，手机都没问题。高云涛: 之前已经告知您了，kindle对wifi信道有要求不是手机可以连接的，kindle就一定可以连接我: 这个没有在说明书上有啊高云涛: 没有这个是您公司的网问题，不是您设备的问题重启路由器，就是简单的拔下电源，然后10秒后充电高云涛: 没有这个是您公司的网问题，不是您设备的问题重启路由器，就是简单的拔下电源，然后10秒后充电请问您还有其他疑问吗？我: 没解决问题

GitHub上star超过2k的安卓MVP架构指南

Tue, 28 Mar 2017 11:06:55 GMT

近日在搜MVP模式作为安卓项目架构时候，发现GitHub上一篇介绍MVP架构的文章。一看star已经超过2K了。通读全文发现作者用实际项目将MVP架构要怎么分职责讲得十分通俗易懂。为了方便大家查阅，把原文翻译了一下。作者还有一篇文章讲安卓项目和代码风格指南的。欢迎查看相关翻译。

架构指南#

我们的安卓APP架构基于 MVP (Model View Presenter) 模式。

View (UI 层):这是 Activities, Fragments 和其他标准安卓控件所在层。它的职责是呈现从Presenter收到的数据给用户。它也处理用户的交互和输入（点击监听等）以及在需要时触发Presenter中对应的动作。
Presenter: Presenter 订阅由 DataManager 提供的 RxJava Observables。他们负责处理订阅的生命周期，分析/修改DataManager返回的数据，调用View中的合适方法以便展示数据。
Model (Data 层): 它们的职责是取回，保存，缓存，以及通知数据。它可以与本地数据库以及其他的数据仓库通信，使用restful API或者其他第三方SDK等方式。它分为两部分：一组帮助工具类以及一个 DataManager 。工具类的数量因项目而异，每一个工具类有特定的功能，比如与API通信或在 SharedPreferences 中保存数据. DataManager 把不同工具类的输出使用rx操作符进行组合变换，所以它可以： 1) 提供有意义的数据给 Presenter，2) 把经常一起出现的动作组合在一起。这一层也包含实际的实体类，定义数据结构是怎样的。

从右到左看示意图:

Helpers (Model): 一组类的集合，每个类有特定的职责，他们的功能可以从与API或数据库通信，到实现一些特定的业务逻辑等。每个项目会有不同的工具类，但最常见的几个是：
- DatabaseHelper: 它处理插入，更新，以及获取来自本地SQLite数据库的数据。它的方法返回 Rx Observables ，发射(译者注：Rx术语)简单java对象 (models)。
- PreferencesHelper: 它保存以及获取来自 SharedPreferences 的数据，他可以返回 Observables 或者直接返回简单java对象。
- Retrofit services : Retrofit 接口使用Restful API 通信，每个不同的API拥有自己的 Retrofit 服务. 它们返回 Rx Observables.
Data Manager (Model): 这是MVP架构的关键部分。它持有每一个工具类的引用，使用这些工具类满足来自Presenter的请求。它的方法广泛的使用 Rx 操作符来组合，转换或过滤来自工具类的输出，以便生成Presenter想要的输出。它返回发射数据模型（data models）的 observables。
Presenters: 订阅由 DataManager 提供的observables，处理这些数据以便调用View中合适的方法。
Activities, Fragments, ViewGroups (View): 实现了一组Presenter可以调用的方法的标准安卓组件。它们也处理用户的交互如点击等，然后调用Presenter中合适的方法来采取相应的行动。这些控件也实现框架相关的任务，如管理安卓生命周期，渲染视图（Views）等。
Event Bus: 它使得View控件得到发生在Model的特定事件通知。通常 DataManager 发出事件，然后这些事件可以被Activities 和 Fragments 订阅。 event bus 仅仅用于非常特别的动作——这些事件不是仅与一个界面相关的，要通知多方，如：用户已经退出登录。原文链接译文链接

GitHub上star超过2k的安卓项目和代码风格指南（绝对干货）

Tue, 28 Mar 2017 11:06:55 GMT

近日在搜MVP模式作为安卓项目架构时候，发现GitHub上一篇介绍MVP架构的文章。一看star已经超过2K了。作者同项目的这篇文章讲安卓项目和代码风格指南，也非常有参考价值。为了方便大家查阅，把原文翻译了一下。点击查看作者介绍安卓MVP架构指南的翻译文章。

1. 项目指南#

1.1 项目结构#

新项目应该遵循安卓Gradle项目结构，定义在这里：安卓Gradle插件用户指南。项目ribot Boilerplate 是一个很好的参考。

1.2 文件命名#

1.2.1 类文件#

类名书写方式是大写的驼峰命名.

继承于安卓组件的类，名称应该以继承的组件命名，比如：SignInActivity, SignInFragment, ImageUploaderService, ChangePasswordDialog.

1.2.2 资源文件#

资源文件书写方式：小写_下划线。如：ic_launcher.png

1.2.2.1 Drawable 文件#

drawable类型资源命名：

资源类别	前缀	例子
Action bar	`ab_`	`ab_stacked.9.png`
Button	`btn_`	`btn_send_pressed.9.png`
Dialog	`dialog_`	`dialog_top.9.png`
Divider	`divider_`	`divider_horizontal.9.png`
Icon	`ic_`	`ic_star.png`
Menu	`menu_`	`menu_submenu_bg.9.png`
Notification	`notification_`	`notification_bg.9.png`
Tabs	`tab_`	`tab_pressed.9.png`

图标（icons）命名方式 (取自安卓图标官方指南):

资源类别	前缀	例子
Icons	`ic_`	`ic_star.png`
Launcher icons	`ic_launcher`	`ic_launcher_calendar.png`
Menu icons and Action Bar icons	`ic_menu`	`ic_menu_archive.png`
Status bar icons	`ic_stat_notify`	`ic_stat_notify_msg.png`
Tab icons	`ic_tab`	`ic_tab_recent.png`
Dialog icons	`ic_dialog`	`ic_dialog_info.png`

selector 状态命名方式:

状态	后缀	例子
Normal (正常)	`_normal`	`btn_order_normal.9.png`
Pressed（按下）	`_pressed`	`btn_order_pressed.9.png`
Focused （获得焦点）	`_focused`	`btn_order_focused.9.png`
Disabled （不可用）	`_disabled`	`btn_order_disabled.9.png`
Selected （选中）	`_selected`	`btn_order_selected.9.png`

1.2.2.2 布局文件#

布局文件应该跟对应的安卓组件名称匹配，但是把最顶级的组件名称放在前面。比如，当我们创建一个用于 SignInActivity的布局，那布局文件名称应该是activity_sign_in.xml.

组件	类名	布局文件名
Activity	`UserProfileActivity`	`activity_user_profile.xml`
Fragment	`SignUpFragment`	`fragment_sign_up.xml`
Dialog	`ChangePasswordDialog`	`dialog_change_password.xml`
AdapterView item	---	`item_person.xml`
Partial layout	---	`partial_stats_bar.xml`

一个稍微不同的地方是当我们创建用于Adapter渲染的布局,如填充一个 ListView，在这种情况下，布局文件命名应该是用 item_开始。注意有些地方这些规则没法应用，如，当我们创建一个布局文件，用于渲染另一个布局的一部分，这样的情况下，我们应该使用partial_前缀。

1.2.2.3 菜单文件#

跟布局文件相似，按钮文件应该跟对应的组件匹配。比如：当我们定义一个菜单，用于 UserActivity,那么文件名应该是 activity_user.xml

文件名不含有menu是个良好的习惯做法，因为这些文件已经位于 menu 目录了。

1.2.2.4 取值文件(Values files)#

在values文件夹的资源文件应该是复数形式（plural），比如，strings.xml, styles.xml, colors.xml, dimens.xml, attrs.xml

2 代码指南#

2.1 Java语言规范#

2.1.1 不要忽略了异常#

你万不该这样做:

1
void setServerPort(String value) {
2
    try {
3
        serverPort = Integer.parseInt(value);
4
    } catch (NumberFormatException e) { }
5
}

虽然你可能觉得你的代码永远不会抛出这个异常或者这异常不重要，不需要处理它，像上面那样忽略异常会在你的代码中留下雷区，将来其他人会踩到。你必须在你的代码中以某种原则的方式处理每个异常。具体的处理视情况而定。._ - (安卓官方代码指南)

指南中关于不要忽略异常的说明在这里.

2.1.2 不要捕获一般的异常。#

你不应该这样做:

1
try {
2
    someComplicatedIOFunction();        // 可能抛出 IOException
3
    someComplicatedParsingFunction();   // 可能抛出 ParsingException
4
    someComplicatedSecurityFunction();  // 可能抛出 SecurityException
5
    //啊哈，统一处理掉
6
} catch (Exception e) {                 //我将捕获所有的异常
7
    handleError();                      // 使用一个通用的处理手段!
8
}

查看不这样做的原因以及要怎么做：猛戳安卓官方指南之不要捕获一般的异常

2.1.3 不要用finalizer#

我们不使用finalizer。它什么时候被调用是没有保证的，甚至它不被调用。大部分情况下，你可以使用良好的异常处理来满足需要在finalizer中做的工作。如果你确实需要它，定义一个 close() 方法（或类似的）然后在文档中明确的指出什么时候这个方法需要被调用。可以查看 InputStream 做为例子.这种情况下，在finalizer中打印一个简短的log信息是恰当的但不是必须的，因为我们不希望log泛滥 ._ - (猛戳安卓官方指南之不要用finalizer)

2.1.4 完全的import语句#

反例: import foo.*;

正解: import foo.Bar;

点击这里查看更多说明

2.2 Java风格规范#

2.2.1 全局变量定义及命名#

全局变量应该定义在文件的头部,遵循下面的命名规则。

私有的非静态全局变量以m开头
私有的静态全局变量以s开头
其他的全局变量以小写单词开头
常量使用全部大写，单词间用下划线间隔（ALL_CAPS_WITH_UNDERSCORES）.

译者注：这个规则取自Android Open Source Project代码贡献规范。在程序员的圈子里对于要不要前缀这个问题已经吵翻天了。我在使用greendao的时候使用前缀的话，自动生成的getter/setter会是getMxxx/setMxxx这样难看的方法。很多人也觉得这个命名规则没有意义。stackOverFlow 还有这里，以及一本教你怎么写出整洁代码的书中如是说： “我觉得如今这些前缀没有意义，尤其是在你的APP中!你的类和方法应该尽量的小，而且你应该使用代码高亮的编辑环境，使得成员变量易于分辨。再者，人们快速适应忽略了前缀或后缀来看名字的有意义部分。我们阅读代码越多，看到前后缀越少。渐渐地，前缀就变成了旧代码看不到的线索和标记。——代码整洁之道(Clean.Code).Robert.C.Martin”

例子:

1
public class MyClass {
2
    public static final int SOME_CONSTANT = 42;
3
    public int publicField;
4
    private static MyClass sSingleton;
5
    int mPackagePrivate;
6
    private int mPrivate;
7
    protected int mProtected;
8
}

2.2.3把首字母缩写当做一个单词来看#

好的例子	不好的例子
`XmlHttpRequest`	`XMLHTTPRequest`
`getCustomerId`	`getCustomerID`
`String url`	`String URL`
`long id`	`long ID`

2.2.4 使用空格缩进#

使用四个空格做代码块缩进:

1
if (x == 1) {
2
    x++;
3
}

换行时使用8个空格缩进:

1
Instrument i =
2
        someLongExpression(that, wouldNotFit, on, one, line);

2.2.5 使用标准的大括号风格#

大括号的开始跟代码同一行

1
class MyClass {
2
    int func() {
3
        if (something) {
4
            // ...
5
        } else if (somethingElse) {
6
            // ...
7
        } else {
8
            // ...
9
        }
10
    }
11
}

条件语句使用大括号包住，除非条件体只有一行。如果条件及只有一行条件体，而且没被换行，大括号是不必的。

1
if (condition) body();

这是不好的:

1
if (condition)
2
    body();  // 不好的，没有大括号包围!

2.2.6 注解#

2.2.6.1 注解实践规范#

根据安卓代码风格指南，一些Java内置的注解标准的实践规范有：

@Override: 无论一个方法是重载父类还是实现某个接口的都必须使用@Override 注解。比如，当你使用 @inheritdocs Javadoc 标签,然后从一个类(不是一个接口)中导出，你也必须声明那个方法 @Overrides 父类的方法。
@SuppressWarnings: @SuppressWarnings 注解应该仅当不可能消除一个警告的时候才使用。如果一个警告通过这个 “不可能消除” 的测试, @SuppressWarnings 注解必不可少, 以便保证所有的警告在代码中反映实际的问题。

关于注解的更多指南可以查看这里.

2.2.6.2 注解风格#

类，方法及构造器

当注解被应用到一个类，方法或者构造函数时候，注解在代码注释之后，一行一个注解

1
/* 这是这个类的注解 */
2
@AnnotationA
3
@AnnotationB
4
public class MyAnnotatedClass { }

全局变量

全局变量的注解应该在同一行列出。除非这一行超过了最大字数了。

1
@Nullable @Mock DataManager mDataManager;

2.2.7 限制变量范围#

变量的使用范围应该限制到最小(Effective Java 条目 29)。这样做，你可以为你的代码增加可读性和可维护性，减少可能的错误。每个变量应该在最内层的使用到的它代码块中定义

局部变量应该在第一次用到他们的时候定义。几乎每个局部变量都应该初始化。如果你没有足够的信息去初始化一个变量，你应该延迟声明这个变量，直到你有足够的初始化信息。._ - (安卓代码风格指南)

2.2.8 排序import语句#

如果你使用IDE,如Android Studio，你不必担心这些规则，这些IDE已经遵循这些规则。如果你不用IDE，往下看这些规则:

import 安卓框架的
Import 来自第三方的(com, junit, net, org)
java 以及 javax
同一个项目的 imports

为了保持跟IDE的设置一致，这些imports应该是这样的：

首字母分组排序，大写的字母在小写的字母前面（如Z在a前面）。
每个主要分组 (android, com, junit, net, org, java, javax)间应该有一行空行。

更多信息查看这里

2.2.9 日志(Loging)指南#

使用 Log 类提供的日志方法来打印错误信息或对开发者分辨问题有用的其他信息：

Log.v(String tag, String msg) (verbose)
Log.d(String tag, String msg) (debug)
Log.i(String tag, String msg) (information)
Log.w(String tag, String msg) (warning)
Log.e(String tag, String msg) (error)

通常来说，我们使用一个类的名称作为一个TAG，在文件的开头定义成一个 static final 变量，如：

1
public class MyClass {
2
    private static final String TAG = MyClass.class.getSimpleName();
3

4
    public myMethod() {
5
        Log.e(TAG, "My error message");
6
    }
7
}

VERBOSE 和 DEBUG 日志必须在release版本中禁用。同时也建议禁用INFORMATION, WARNING 和 ERROR 日志，但是你可能觉得它们在release版本中定位问题很有用而保持启用。如果你决定让他们保持启用，你要保证这些日志信息不会泄漏email地址，用户id之类的隐私信息。仅限debug版本显示Log的配置：

1
if (BuildConfig.DEBUG) Log.d(TAG, "The value of x is " + x);

2.2.10 类成员排序#

这虽然没有简单正确的方案，但是使用一个 逻辑的 及 ** 一致的 ** 顺序可以提高代码的可读性和可学习性。下面是推荐的顺序：

常量
全局变量
构造函数
重载的函数和回调 (public 或 private)
Public 方法
Private 方法
内部类或内部接口

例子:

1
public class MainActivity extends Activity {
2

3
  private String mTitle;
4
    private TextView mTextViewTitle;
5

6
    public void setTitle(String title) {
7
      mTitle = title;
8
    }
9

10
    @Override
11
    public void onCreate() {
12
        ...
13
    }
14

15
    private void setUpView() {
16
        ...
17
    }
18

19
    static class AnInnerClass {
20

21
    }
22

23
}

展开收起

如果你的类继承一个安卓组件如Activity或Fragment，对重载的方法进行排序以便跟组件的生命周期匹配是一个最佳实践。比如，当你的Activity实现onCreate(), onDestroy(), onPause() 和 onResume()，正确的顺序是：

1
public class MainActivity extends Activity {
2

3
  //顺序跟Activity的生命周期匹配
4
    @Override
5
    public void onCreate() {}
6

7
    @Override
8
    public void onResume() {}
9

10
    @Override
11
    public void onPause() {}
12

13
    @Override
14
    public void onDestroy() {}
15

16
}

展开收起

2.2.11 方法的参数顺序#

在安卓编码时候，定义一个方法拥有一个Context参数是非常常见的，如果你写一个这样的方法，Context应该是第一个参数。

相反的例子是回调接口，它应该是最后一个参数例子:

1
// Context 总是在第一个位
2
public User loadUser(Context context, int userId);
3

4
// 回调总是在最后一位
5
public void loadUserAsync(Context context, int userId, UserCallback callback);

2.2.13 字符串常量，命名和取值#

很多安卓SDK的元素如SharedPreferences, Bundle, 或 Intent使用键值对实现，所以即使是一个小应用，使用一堆字符串常量也是很常见的。

当使用这些组件，你必须定义这些键是 static final 变量，并且它们应该像下面这样使用前缀

元素	变量名前缀
SharedPreferences	`PREF_`
Bundle	`BUNDLE_`
Fragment Arguments	`ARGUMENT_`
Intent Extra	`EXTRA_`
Intent Action	`ACTION_`

注意Fragment的参数——Fragment.getArguments()也是一个Bundle。然而，因为这是Bundle非常常见的用法，我们为它定义一个不同的前缀。

例子:

1
//注意这些变量的值应该和名称一致来避免问题
2
static final String PREF_EMAIL = "PREF_EMAIL";
3
static final String BUNDLE_AGE = "BUNDLE_AGE";
4
static final String ARGUMENT_USER_ID = "ARGUMENT_USER_ID";
5

6
//Intent相关的使用完全包名作为值
7
static final String EXTRA_SURNAME = "com.myapp.extras.EXTRA_SURNAME";
8
static final String ACTION_OPEN_USER = "com.myapp.action.ACTION_OPEN_USER";

2.2.14 Fragment和Activity的参数#

当数据通过Intent 或Bundle传递到一个Activity 或 Fragment，这些不同值的键必须遵循上面描述的规则。

当一个 Activity 或 Fragment 想要参数，它应该提供一个public static方法来简化对应的Intent 或 Fragment创建在Activity中这个方法通常叫 getStartIntent():

1
public static Intent getStartIntent(Context context, User user) {
2
  Intent intent = new Intent(context, ThisActivity.class);
3
  intent.putParcelableExtra(EXTRA_USER, user);
4
  return intent;
5
}

对于Fragment它的名称是newInstance()，处理使用合适的参数创建Fragment。

1
public static UserFragment newInstance(User user) {
2
  UserFragment fragment = new UserFragment;
3
  Bundle args = new Bundle();
4
  args.putParcelable(ARGUMENT_USER, user);
5
  fragment.setArguments(args)
6
  return fragment;
7
}

注意1: 这些方法应该在类的 onCreate()前面

注意2: 如果我们提供上面说的方法，这些extras对应的键和参数应该是private 的，因为他们不需要暴露到类以外。

2.2.15 代码行长度限制#

代码行不应该超过100 个字符。如果代码行超过这个限制长度，通常有两种方式来降低长度：

提取一个局部变量或方法（推荐方式）.
把单行换行成多行。

有两种例外可以让一行超过100字符：

这行不可分割，如长URL。
package 和 import 语句.

2.2.15.1 换行策略#

没有精确的公式解释怎么换行，很多不同的方案是有效的。然而，这里有几个规则可以应用到常见情况。 在操作符前断开

当一行被操作符断开，断开处应该在操作符之前，例子如下：

1
int longName = anotherVeryLongVariable + anEvenLongerOne - thisRidiculousLongOne
2
        + theFinalOne;

赋值符号（=）例外

在操作符前断开有一个例外，那就是赋值符号 =，应该在赋值符号后面断开。

1
int longName =
2
        anotherVeryLongVariable + anEvenLongerOne - thisRidiculousLongOne + theFinalOne;

方法链的情况

当多个方法被链接在同一行的时候——如使用Builder时，每一个方法的调用应该在独立一行，在 .之前断开。

1
Picasso.with(context).load("http://ribot.co.uk/images/sexyjoe.jpg").into(imageView);

1
Picasso.with(context)
2
        .load("http://ribot.co.uk/images/sexyjoe.jpg")
3
        .into(imageView);

长参数的情况

当一个方法有很多参数或它的参数非常长，我们应该在每个逗号 ,后面断开

1
loadPicture(context, "http://ribot.co.uk/images/sexyjoe.jpg", mImageViewProfilePicture, clickListener, "Title of the picture");

1
loadPicture(context,
2
        "http://ribot.co.uk/images/sexyjoe.jpg",
3
        mImageViewProfilePicture,
4
        clickListener,
5
        "Title of the picture");

2.2.16 RxJava 链式风格#

Rx链式操作符要求换行。每一个操作符必须在新的一行，断行应该在.之前

1
public Observable<Location> syncLocations() {
2
    return mDatabaseHelper.getAllLocations()
3
            .concatMap(new Func1<Location, Observable<? extends Location>>() {
4
                @Override
5
                 public Observable<? extends Location> call(Location location) {
6
                     return mRetrofitService.getLocation(location.id);
7
                 }
8
            })
9
            .retry(new Func2<Integer, Throwable, Boolean>() {
10
                 @Override
11
                 public Boolean call(Integer numRetries, Throwable throwable) {
12
                     return throwable instanceof RetrofitError;
13
                 }
14
            });
15
}

展开收起

2.3 XML 风格规定#

2.3.1 使用自关闭的标签#

当一个XML元素没有任何内容时，你必须使用自关闭标签。这是好例子:

1
<TextView
2
  android:id="@+id/text_view_profile"
3
  android:layout_width="wrap_content"
4
  android:layout_height="wrap_content" />

这是不好的例子 :

1
<!-- 不要这样做! -->
2
<TextView
3
    android:id="@+id/text_view_profile"
4
    android:layout_width="wrap_content"
5
    android:layout_height="wrap_content" >
6
</TextView>

2.3.2 资源命名#

资源 ID 和名称使用小写加下划线方式 lowercase_underscore.

2.3.2.1 ID 命名#

ID应该使用小写加下划线命名，加上元素名称为前缀，如：

元素	前缀
`TextView`	`text_`
`ImageView`	`image_`
`Button`	`button_`
`Menu`	`menu_`

Image view 例子:

1
<ImageView
2
    android:id="@+id/image_profile"
3
    android:layout_width="wrap_content"
4
    android:layout_height="wrap_content" />

Menu 例子:

1
<menu>
2
  <item
3
        android:id="@+id/menu_done"
4
        android:title="Done" />
5
</menu>

2.3.2.2 字符串#

字符串名称以它们所属的部分为前缀命名，比如registration_email_hint 或 registration_name_hint。如果一个字符串不属于任何部分，那么你应该遵循下面的规则：

前缀	描述
`error_`	An error message
`msg_`	A regular information message
`title_`	A title, i.e. a dialog title
`action_`	An action such as “Save” or “Create”

2.3.2.3 Styles 和 Themes#

不像其他的资源，style命名方式是大写的驼峰是命名UpperCamelCase

2.3.3 属性顺序#

作为通用的规则，你应该把相似的属性放在一起分组，一个对常见属性良好的排序方式是

View Id
Style
布局的宽和高
其他的布局属性，按字母排序
剩下的属性，按字母排序

2.4 测试风格规定#

2.4.1单元测试#

测试类应该跟需要测试的类名字对应，以Test做后缀。比如我们创建一个测试类包含对DatabaseHelper的测试，我们应该把它命名为 DatabaseHelperTest。

测试方法用@Test注解，通常以要测试的方法名为命名开始，以测试的前置条件及/或期望结果做后缀。

模板: @Test void methodNamePreconditionExpectedBehaviour()
例子: @Test void signInWithEmptyEmailFails()

如果没有它们测试也能够清楚的表达，前置条件和/或期望结果不总是必须的。

有时候一个类可能包含一大堆方法，同时每个方法要求多个测试，在这种情况，推荐把测试类分割成几个。比如，如果 DataManager包含一大堆方法，我们可能想把它分到 DataManagerSignInTest, DataManagerLoadUsersTest等等。通常你能够知道哪些测试应该在一起，因为它们有共同的test fixtures.

2.4.2 Espresso 测试#

每一个 Espresso 测试类目标通常是一个Activity，所以它的名称应该跟目标Activity的名称匹配，以Test结束，如 SignInActivityTest

当使用 Espresso API ，把链式方法调用放新行是一个最佳实践。

1
onView(withId(R.id.view))
2
        .perform(scrollTo())
3
        .check(matches(isDisplayed()))

原文链接译文链接

Evernote带来的计划任务神器Android-Job

Thu, 23 Mar 2017 07:56:55 GMT

在新版本安卓版本(API23以上)中，谷歌把android.net.conn.CONNECTIVITY_CHANGE 这个广播废弃了。总的来说，应用不应该依赖这个广播来执行相关任务，而应该使用 JobScheduler 或者 GCMNetworkManager。计划任务的执行方案还可以用 AlarmManager。对于国内的开发者来说，这是一个悲剧。Android 现在提供这三种不同的API来执行计划任务.这三种API都有各自的优缺点。 android.net.conn.CONNECTIVITY_CHANGE 在高版本的系统中不可用了，JobScheduler 在低版本的系统中又不可用， GCMNetworkManager 是什么？在国内不存在。而且这些API之间的不同语义和用法对开发者是一种额外的负担。这种负担体现在我们不仅仅要懂得什么时候使用合适的API,而且要为不同的环境执行同样任务提供不同分支的代码。APP需要在运行时候用合适的条件判断到底要使用哪种方式执行计划任务。幸运的是，开源的世界有伟大的公司为我们提供了灵活的轮子。

Evernote 开源的 Android-Job 为我们带来兼容这三种API的方案，高效，简单，灵活。Android-Job 在运行判断使用哪种API，它提供 AlarmManager, JobScheduler和 GcmNetworkManager功能的超集，比如说，我们可以定义计划任务在网络连通且在充电时候执行。

为兼容而生#

上面提到的三种方案，兼容维护非常麻烦。为了彰显Android-Job的价值，我们有必要对这三种方案做一个分析。

AlarmManager#

AlarmManager 的API一直在改变，所以我们需要非常注意我们APP目标运行系统是哪个版本。

** 优点 **

所有设备上可用
发送广播来启动一个服务执行计划很容易

** 缺点 **

API在不同系统版本表现不一致
太多样板代码
忽略了设备的状态
alarmManager

JobScheduler#

JobScheduler 只在Lollipop以上版本可用。

** 优点 **

流式API简洁易用
检查设备状态

** 缺点 **

只在API 21+ 可用（有些功能要求API24+）
平台bug
也是太多样板代码

GcmNetworkManager#

GcmNetworkManager 只有在安装有Google Play的设备上可用，而且，没有被墙。

** 优点 **

跟JobScheduler相似的API
要求minSdkVersion 9

** 缺点 **

是 GooglePlay ServicesSDK 的一部分
不能脱离 Play Services 运行
API 有很多陷阱

例子#

Android-Job项目作者在一篇PPT中详细的说明了这三种方案以及Android-Job的用法。由于篇幅有限且排版原因，强烈建议点击链接去看看。例子简单易懂，在这里给出PPT对应的PDF文件。还在犹豫是否要使用 Android-Job ，看了这个PDF，相信你心里就有肯定的答案了 PDF传送门

使用Android-Job(翻译自项目说明)#

请保证点击以下链接检查你使用的是否是最新版本Android-Job最新版链接添加以下的Gradle配置到安卓项目：

1
// 在app 项目的 build.gradle 文件:
2
dependencies {
3
    compile 'com.evernote:android-job:1.1.7'
4
}

如果没有在 Gradle build tools 中关闭 manifest merger，那就不用更多步骤来配置这个工具库了。否则需要手动添加权限生命和services，参考这个AndroidManifest

用法#

JobManager 类作为入口。我们自定义的Jobs 需要继承 Job 类。使用对应的Builder类创建一个 JobRequest 然后使用 JobManager 创建这个计划请求。

使用 JobManager 之前必须向初始化这个单例。我们需要提供一个 Context 然后添加一个 JobCreator 实现类. JobCreator 把一个job tag 映射到一个特定的job 类。推荐在 Application 的 onCreate() 方法中初始化 JobManager 。如果没有 Application 类的访问权限，这是可选的方案。

1
public class App extends Application {
2

3
    @Override
4
    public void onCreate() {
5
        super.onCreate();
6
        JobManager.create(this).addJobCreator(new DemoJobCreator());
7
    }
8
}

1
public class DemoJobCreator implements JobCreator {
2

3
    @Override
4
    public Job create(String tag) {
5
        switch (tag) {
6
            case DemoSyncJob.TAG:
7
                return new DemoSyncJob();
8
            default:
9
                return null;
10
        }
11
    }
12
}

然后我们可以开始计划要执行的任务。

1
public class DemoSyncJob extends Job {
2

3
    public static final String TAG = "job_demo_tag";
4

5
    @Override
6
    @NonNull
7
    protected Result onRunJob(Params params) {
8
        // run your job here
9
        return Result.SUCCESS;
10
    }
11

12
    public static void scheduleJob() {
13
        new JobRequest.Builder(DemoSyncJob.TAG)
14
                .setExecutionWindow(30_000L, 40_000L)
15
                .build()
16
                .schedule();
17
    }
18
}

展开收起

进阶用法#

JobRequest.Builder 类有很多额外的配置选项，例如，我们可以声明条件：需要网络连接。为了使任务周期性执行，用 bundle 传递额外的参数，使得任务在重启后或在特定的时间恢复。每一个Job 有一个唯一的 ID 。这个 ID 帮助我们辨别 job ，以便将来更新条件或者取消 job。

1
private void scheduleAdvancedJob() {
2
    PersistableBundleCompat extras = new PersistableBundleCompat();
3
    extras.putString("key", "Hello world");
4

5
    int jobId = new JobRequest.Builder(DemoSyncJob.TAG)
6
            .setExecutionWindow(30_000L, 40_000L)
7
            .setBackoffCriteria(5_000L, JobRequest.BackoffPolicy.EXPONENTIAL)
8
            .setRequiresCharging(true)
9
            .setRequiresDeviceIdle(false)
10
            .setRequiredNetworkType(JobRequest.NetworkType.CONNECTED)
11
            .setExtras(extras)
12
            .setRequirementsEnforced(true)
13
            .setPersisted(true)
14
            .setUpdateCurrent(true)
15
            .build()
16
            .schedule();
17
}
18

19
private void schedulePeriodicJob() {
20
    int jobId = new JobRequest.Builder(DemoSyncJob.TAG)
21
            .setPeriodic(TimeUnit.MINUTES.toMillis(15), TimeUnit.MINUTES.toMillis(5))
22
            .setPersisted(true)
23
            .build()
24
            .schedule();
25
}
26

27
private void scheduleExactJob() {
28
    int jobId = new JobRequest.Builder(DemoSyncJob.class)
29
            .setExact(20_000L)
30
            .setPersisted(true)
31
            .build()
32
            .schedule();
33
}
34

35
private void cancelJob(int jobId) {
36
    JobManager.instance().cancel(jobId);
37
}

展开收起

如果非周期性的 Job 执行失败,我们可以设定恢复标准重新计划这个 job

1
public class RescheduleDemoJob extends Job {
2

3
    @Override
4
    @NonNull
5
    protected Result onRunJob(Params params) {
6
        // 一些异常情况发生，稍后重试这个Job
7
        return Result.RESCHEDULE;
8
    }
9

10
    @Override
11
    protected void onReschedule(int newJobId) {
12
        // 恢复的Job有一个新的 ID
13
    }
14
}

提醒: 谷歌在安卓 Marshmallow 版本引入自动备份功能，所有的 job 信息保存在一个文件名为 evernote_jobs.xml的 shared preference ，以及文件名为evernote_jobs.db 的数据库中. 我们应该排除这些文件，避免他们被自动备份。我们可以定义一个resource XML 文件 (比如, res/xml/backup_config.xml) 内容如下:

1
<?xml version="1.0" encoding="utf-8"?>
2
<full-backup-content>
3
    <exclude domain="sharedpref" path="evernote_jobs.xml" />
4
    <exclude domain="database" path="evernote_jobs.db" />
5
</full-backup-content>

然后在应用的 AndroidManifest.xml指向这个文件:

1
<application ...  android:fullBackupContent="@xml/backup_config">

代码混淆#

这个库没有使用反射，但是它依赖两个 Service 以及两个 BroadcastReceiver 为了避免任何可能出现的问题，不应该混淆这四个类。这个库打包了它自己的混淆配置，所以我们不需要做任何额外的配置。以防万一，也可以在我们项目的混淆配置中添加这些规则

FAQ#

点击这里查看更多的疑问解答。

参考资料#

evernote的Blog 作者Ralf的PPT

Linux 命令手册安卓版

Wed, 22 Mar 2017 11:30:55 GMT

前两天逛GitHub时候发现了一个命令行手册项目jaywcjlove/linux-command 手册网站，觉得非常实用。GitHub的Pages很方便，但是国内访问有时候比较慢。虽然网上类似的在线手册很多了，但是我觉得一个手册应该是随手可用，而且即使在没有网时候，也可随时翻阅的。于是打算用一天半天把手册做成个离线版简易手册APP。

准备工作#

翻了一下GitHub上项目的README，发现作者很贴心的把爬虫抓到的数据保存成MarkDown格式了。不得不说一下，MarkDown是程序员最喜欢的文档格式之一。把项目clone到本地，手册的数据来源就准备好了。再次感谢作者的辛勤付出。

MarkDown解析#

安卓没有原生支持MarkDown的控件，在GitHub上用markdown为关键字搜了一下，pegdown 这个MarkDownn解析库是最多star的。遗憾的是，尽管目前仍然是最流行的MarkDown解析库之一，作者在三个多月前声明这个项目停止维护了。不过作者推荐了@vsch的flex-mark-java,另一个性能优越的markdown解析库。

flexmark-java解析架构基于commonmark-java,另一款解析库(开源的世界就是这么任性啊),想到罗永浩的那句生命不息，折腾不止，决定先用commonmark-java解析，后面再切换到flexmark-java。尽管是最简单的引用，并没有怎么折腾。

搜索功能#

手册的数据，解析都准备好了，还有一个手册必不可少的功能——搜索。以前做项目的时候都是用EditText+Button来实现搜索功能的。虽然一直知道安卓有个原生的searchView，但是项目做视觉设计的小伙伴设计出来的视觉不给searchView用武之地。自从进TV应用开发的坑后，也好久没有开发手机APP了。基于这两个原因，决定在这个小应用中学习一下searchView的使用。计划实现的是带搜索建议的searchView,这样可以尽量的简化在手机上的输入。searchView的配置很简单，但是搜索建议需要有一定的学习。安卓现在推荐的是ActionBar中搜索，除了要增加一点actionView的配置，其他的跟searchView大同小异。正所谓磨刀不误砍柴工，何况之前没有系统的学习过searchView，于是开始找百度，找博客补习功课。以searchView搜索看了几篇配置博文后，发现一个博客把谷歌的searchView介绍做了一个专题的介绍，于是把这几篇文章细读了一遍。在读这几篇译文的时候想起很多大牛的教导，要读就读一手的文档，最好是出自代码作者之手的，再次一点就是读一手文档的翻译。除了这两种文章干货较多，其他类型的文章往往介绍得不够全面。英文原文（需要翻墙）译文第一篇：[Searchable(一)](剩下的几篇链接就不贴了，在文末有上下篇的链接跳转)

依照译文的介绍，我对搜索功能有了大概的方向。主要做了以下几点：

把前面获取到的MD文件放到assets目录下，用AssetsManager进行管理，这样就可以不用数据库了。展示命令详情的时候，也可以直接读取到命令对应文件流，再方便不过了。
searchView的搜索建议需要有一个ContentProvider来提供搜索建议的数据源，没有数据库怎么用ContentProvider? 答案是MatrixCursor。MatrixCursor可以做到模拟数据库的作用，也提供方法方便插入数据等。
有了实现ContentProvider的思路,只需把AssetsManager获取到的命令文件名作为数据，提供给searchView来查询就可以了。

总结#

手册的实现并没有什么难度，在补充了相关的知识后，只需要不到半天的时间就可以搞定了。项目虽小，但是还是给我不少收获的。之前看到有一篇文章，名字叫《提问的智慧》。搜索其实就是向机器提问的一种方式，科学的搜索关键词，合适的网站搜索事半功倍。搜索还是首选 Google.com 和 stackoverflow.com

项目地址： GitHub coding.net

Lottie,我们幕后新的开源动效工具

Mon, 20 Mar 2017 04:30:55 GMT

airbnb开源了一套适用于Android和iOS动效库。虽然尚在快速迭代中，但是已经忍不住在项目中小范围试用。无奈新开源的项目文档比较少。在airbnb设计部门的网站上看到一篇介绍Lottie的文章，试着翻一下。本文是第一次翻译英文文档，翻译不当或不专业的地方欢迎指教。

在过去，为Android，IOS,React Native应用创建复杂的动效，是一个困难又费时的过程。您要么为每种屏幕分辨率添加笨重的图像文件，要么写上千行难以扩展维护的代码。正因为如此，尽管动效是一个沟通的想法和创造引人注目的用户体验的强大工具，大多数应用程序并不使用动效。一年前，我们开始改变这种情况。

今天，我们很高兴介绍我们的解决方案。Lottie是一个可用于iOS，Android和React Native 的库，实时渲染 After Effects动效，并允许开发者在原生应用程序中使用动效像使用图片等静态资源一样简单。Lottie使用一个开源的After Effects插件(Bodymovin)导出的JSON文件形式的动效数据，这个插件捆绑了一个JavaScript播放器，可以在网络上渲染动画。从2015二月开始，Bodymovin的作者Hernan Torrisi，每月通过给插件增加新功能，改进现有功能，为我们的Lottie项目建立了一个坚实的基础。我们的团队（Brandon Withrow负责iOS，Gabriel Peal负责Android，Leland Richardson负责React Native，我负责体验设计）在Torrisi的杰出工作基础上开始Lottie开发之旅。

Lottie使得程序猿无痛实现丰富的动效。如上图所示的Nick Butcher跳跃动效，Bartek Lipinski的汉堡式菜单，Miroslaw Stanek的推特心等等，如果用代码从头开始实现四多么困难和费时。有了Lottie，诸如深入了解框架，预估动画时间，手动创建贝赛尔曲线，重新制作GIF参考动效将成为过去式。现在程序猿可以准确地使用设计师设计的动效，确切地说动效是如何制造的，我们实现的就是怎样。为了展示这一点，我们已经重新创建上面的动画，并在我们的示例应用程序提供After Effects和JSON文件。

我们的目标是尽我们所能支持尽可能多的After Effects 的功能，而不仅仅是简单的图标动画。我们还创建了一些其他示例来显示Lottie库的灵活性、丰富性和进阶功能集。在示例应用程序中，还有各种不同类型动画的源文件，包括基本线条艺术、基于字符的动效以及多角度的logo动效。

我们已经在屏幕的各个角落开始使用我们设计的Lottie动效，包括下图所示的应用程序的通知，全帧动画插图，回访评价页面等。我们计划通过有趣且有用的方式大幅度扩大动画使用。

灵活高效的解决方案#

Airbnb是支持数以百万计的房东和房客的全球化公司，所以有一个灵活的动画格式，且可以在多种平台上使用，对我们而言非常重要。现在已经有与Lottie相似的动效库，如Marcus Eckert的Squall和Facebook的Keyframes。但我们的目标稍有不同。Facebook挑选了一小部分After Effects的功能提供支持，因为他们主要集中在交互，但我们想支持尽可能多。至于Squall，Airbnb的设计师用它和Lottie组合使用，因为它有一个神奇的After Effects预览APP，所以成为我们工作中必不可少的一部分。然而，它只支持iOS，但是我们的工程团队需要一个跨平台的解决方案。

Lottie有几个功能内置了它的API，使其更加灵活和高效。它支持从网络上加载JSON文件，这对A / B测试非常有用。它也有一个可选的缓存机制，所以经常使用的动画，如愿望列表的心型图标可以每次加载缓存的副本。Lottie也可以使用动效的进度功能实现用手势调整动画的进度，以及通过改变一个简单的值从而改变动画的速度。iOS版本甚至支持在运行时向动画添加额外的本地UI，可用于复杂的动画转换。

我们工作到目前为止，除了所有的After Effects功能和API的补充，也有很多未来的想法。这些包括映射View到Lottie动画，使用Lottie控制的View的转换，提供Battle Axe的 RubberHose，梯度，类型和图像的支持（译者注：最新版已经支持图像）。最难的部分是下一步先挑选哪些功能实现。

构建社区#

发布开源的东西不仅仅是把它放在那里供大家使用。它是连接人们和创造社区的桥梁。随着我们通过GitHub发布Lottie给设计师和程序猿而走得更近，我们希望确保与动画分支连接。（As we got closer to releasing Lottie to designers and engineers via GitHub, we wanted to be sure to connect with the animation folks as well.）

我们的灵感来自9 Squares, Motion Corpse, 以及 Animography 创造的社区。这三个社区都汇集了来自世界各地的人，如果没有这些社区他们将不能在公共动画项目上合作。这些项目需要数月的工作以及组织各自的团队跟人们进行讨论，但这些毋容置疑作为一个整体为动画社区提供了巨大的价值。Motion Corpse 和Animography 公开分享After Effects 源文件，提供关于人们如何创作的不同见解。

追随他们的协作的领先脚步，我们达成协议，这三个团队贡献动画到我们的示例应用程序中。如下图所示，我们已经包括了由J.R. Canest创建一个动画（来自Motion Corpse），一个来自Al Boardman squares的动效，和一个使用animography Mobilo动画字体的动效键盘，包含20多个艺术家设计的字母。我们希望整合这些动画社区，强大的工程社区将擦除独特的火花。

我们很乐意听到你如何使用Lottie-不管你是一名设计师，动画设计师还是程序猿。随时联系我们直接与你们的思想，lottie@airbnb.com反馈和见解。我们很高兴看到世界各地的社区以我们从未想过的方式开始使用Lottie。

译者注：airbnb已上线一个Lottie动效采集分享网站 lottiefiles.com

下载 Bodymovin, LottieiOS, Android 以及 React Native.

这篇文章由 Brandon Withrow, Gabriel Peal 以及 Salih Abdul-Karim 共同完成

英文版原文链接译文原文链接

greenDAO项目实战-ToOne-ToMany实现一对一，一对多关联映射

Mon, 20 Mar 2017 03:14:27 GMT

在上一篇文章greenDAO项目实战中，我们对GreenDao有了初步的认识。今天我们熟悉一下GreenDao中使用ToOne和ToMany实现一对一，一对多关联映射。本文在上篇的基础上进行。

添加Category类#

我们现在对上一篇的Note进行扩展，添加类别。我们假设一个Note属于一个类别Category，一个类别Category可以拥有多个Note.

1
@Entity
2
public class Category {
3
    @Id
4
    private Long id;
5
    private String name;
6
    @ToMany(referencedJoinProperty = "categoryId")
7
    private List<Note> notes;

修改Note类，Category信息#

1
@Entity
2
public class Note {
3
    @Id(autoincrement = true)
4
    private Long id;
5
    @NotNull
6
    private String text;
7
    private String comment;
8
    private java.util.Date date;
9

10
    @Convert(converter = NoteTypeConverter.class, columnType = String.class)
11
    private NoteType type;
12

13
    private Long categoryId;
14

15
    @ToOne(joinProperty = "categoryId")
16
    private Category category;
17
    //省略了其他的geter,setter
18
}

展开收起

注解分析#

上面的Category类代码中： @ToMany(referencedJoinProperty = "categoryId")这个注解表明，一个Category可以拥有多个Note（一对多）.referencedJoinProperty= "categoryId"表示使用Note类中的categoryId字段进行关联。注意这个字段应该是Long类型.在Category中用 List<Note> notes表示拥有的Note.

上面的Note类代码中： @ToOne(joinProperty = "categoryId")这个注解表明，一个Note属于一个Category。注意我们添加了private Long categoryId这字段，然后在@ToOne注解中使用joinProperty = "categoryId"把Category用categoryId关联起来。

经过在一的端（Category）使用@ToMany，在多的端（Note）使用@ToOne,我们就把一对多和多对一关联关系建立起来了。

使用#

1
       //添加一个类别:技术分享.
2
        Category category = new Category(1L,"技术分享");
3
        categoryDao.insert(category);
4

5
        //添加一个类别:心灵鸡汤.
6
        category = new Category(2L,"心灵鸡汤");
7
        categoryDao.insert(category);
8

9
        //添加一条技术分享note记录
10
        Note note = new Note();
11
        note.setText("这是note内容文本，技术分享");
12
        note.setComment("这是note的comment");
13
        note.setDate(new Date());
14
        note.setType(NoteType.TEXT);
15
        note.setCategoryId(1L);//设置分类为技术分类
16
        noteDao.insert(note);
17

18
        //再添加一条技术分享note记录
19
        note = new Note();
20
        note.setText("这是note内容文本，也是技术分享");
21
        note.setComment("这是note的comment");
22
        note.setDate(new Date());
23
        note.setType(NoteType.TEXT);
24
        note.setCategoryId(1L);//设置分类为技术分类
25
        noteDao.insert(note);
26

27
        //接着添加一条属于心灵鸡汤Note记录
28
        note = new Note();
29
        note.setText("这是note内容文本，心灵鸡汤");
30
        note.setComment("这是note的comment");
31
        note.setDate(new Date());
32
        note.setType(NoteType.TEXT);
33
        note.setCategoryId(2L);//设置分类为心灵鸡汤
34
        noteDao.insert(note);
35

36
        //查询所有的分类为技术分享（id=1）的note数据
37
        List<Note> notes = categoryDao.load(1L).getNotes();
38
        System.out.println(notes);
39
        //通过Note反查Category
40
        noteDao.load(1L).getCategory().getName();
41

42
        //顺便演示一下通过对文本内容的模糊查询匹配返回包含"心灵鸡汤"文本的Note。
43
        notes = noteDao.queryBuilder().where(NoteDao.Properties.Text.like("%心灵鸡汤%")).list();
44
        System.out.println(notes);

展开收起

微信公众号没有你想的那么简单

Sat, 18 Mar 2017 07:56:58 GMT

前言#

老婆在一个艺术培训中心上班，最近她的领导说想要开一个公众号。由于他们对这一块一窍不通，于是咨询起我这个专业人士来。说实话我只是个人捣鼓过微信公众号开发，没有运营或者开发商业微信公众号。但是对于其中的原理还是大概了解的。这不说不要紧，经过跟老婆的一番讨论，发现无论是开发还是运营一个微信公众号，都没有想象中那么简单。

这篇文章不讨论大企业的微信公众号，我们讨论一下像他们这种小微型企业的需求以及他们可能遇到的坑。

需求分析#

首先我们明确一下大概的背景和需求。公司有两三个领导，员工不多，几个人负责教务管理，属于培训中心的后勤保障。剩下的就是几十个老师定期上课培训。培训课有中国舞，芭蕾舞，书法画画，围棋等等。每个培训班人数从几个到十几个不等。那使用这套系统的人就有以下几类：

培训中心的领导
教务员工
培训老师
家长学生
目前没有孩子参加培训，将来可能参加的潜家长

系统的使用人群种类不算多，人数顶多也就是上千。我们大概梳理一下可能的需求。

对于领导：

查看中心运营情况。包括财务收支，招生情况，课程开设情况等
管理审批。主要是培训老师的管理，员工管理，以及财务和开设课程管理

对于员工：

查看管理招生情况，课程开设情况等。跟领导的需求差不多，只不过有些数据只有领导有权限查看操作。
上传下达。主要是录入信息向领导汇报财务收支，招生情况，课程运营情况等。向老师和家长通知开停课通知，收费缴费及活动通知等。

对于家长：

中心信息查询。包括中心的办学情况，课程开设情况，老师简介等。
课程查询。包括课程费用，上课时间，剩余课时等。
费用查询。包括缴费记录，剩余费用，续费等。
通知查询。主要是通过微信推送通知信息。

附上跟老婆讨论时候画的一张思维导图，反映了目前大部分需求。

培训管理系统需求

方案选择#

摆在他们面前的有两种方案。

购买专门为这个行业定制的一整套系统。
请一个开发团队针对他们的需求进行开发。

两种方案各有优劣，我们用表格的方式对比一下。

	购买行业已有系统	找团队定制开发
价格	参差不齐,根据系统功能和公司销售策略而定	根据需求定，可议价性高
后期费用	主要是后期的维护服务费，相关硬件设备（IC卡，打卡机等）购置费	主要是保证系统正常运行的主机，带宽，域名费用等。
功能	功能丰富，能满足大部分需要，但可定制化不高，很多功能用不上	由需求方提出，一般没有累赘的功能。但需求不够明确容易漏掉某些需要的功能
维护	一般由开发公司维护，每个月收取维护服务费	开发完成后有一段维护期，到期后不负责维护或要根据情况收取维护费用
系统稳定性	取决于开发公司，一般有专人维护，能够保证系统正常运行.由于系统不止一家同行业公司使用，系统出现重大问题概率不高	取决于开发质量。在系统试运行期间可能问题较多
数据安全性	取决于开发公司。如果终止合同，使用其他公司产品，或者开发公司倒闭，数据得不到保障	数据保存在云服务器上，可按需备份。
数据可用性	只能在系统内使用，不可定制，进一步分析利用。部分系统可导出到文件	可根据需要对数据进行进一步定制，分析，利用
扩展性	取决于开发公司。有的开发公司提供有限的有偿的二次开发。可扩展性不高	可按需由原开发者或找新的开发者开发定制

结论#

经过上面的对比，我们可以看出无论是购买行业已有系统还是找团队定制开发，都不是像去超市购买商品那样一次性搞定。从方案选择就有很多因素需要长远考虑。

总的来说，购买行业已有系统前期要付出的精力会少很多，但是对系统的依赖较大，一旦选择了，对系统就产生了高度的依赖，很难切换到其他的产品。这种依赖会随着时间和数据的积累越来越难摆脱。终止合同或更换系统对已有数据几乎是毁灭性的从头再来。

而找团队定制开发很大程度取决于需求够不够明确，以及开发团队的质量。对于技术没有大概了解的，不容易看出潜在的风险。这风险包括由于开发团队一般不熟悉这个行业，对需求的理解会有所偏差，开发出来的系统是否符合现有需求以及将来的扩展需要，系统的质量也要一段时间的使用才能得知。

其实无论是开一个微信公众号还是开发一个APP，或者是上一套系统，都会面临着同样的问题。这也就很好理解为什么那么多公司迟迟没有用上现代化的系统，甚至仍然停留在纸和笔或者word，excel来处理各种事务了。

greenDAO项目实战

Thu, 16 Mar 2017 09:13:27 GMT

在安卓移动APP开发过程中，一般使用安卓默认的sqlite数据库做数据持久化存储。虽然android提供了ContentProvider等框架支持，但是写SQL语句依然是一件不少程序猿的头疼的事。无论是简单的SQL语句，还是复杂的多表查询，都是影响开发效率的苦力活。幸运的是，我们有类似于Hibernate/MyBatis的ORM框架用于安卓开发中。今天我们介绍gitHub上热门的一个专注于Android开发的ORM框架——greenDAO.

greenDAO简介#

greenDAO是一个轻量&快速的安卓ORM框架,把对象和Sqlite数据库关联映射起来。它专门为Android做了高度的优化，高性能，消耗极少的内存。 greenDAO首页, 开发文档以及技术支持链接: http://greenrobot.org/greendao/

greendao图解

GreenDAO特色功能：

稳健：GreenDAO从2011开始，就被无数著名的应用程序使用
超级简单：简洁直截了当的API，支持注释（V3以上版本）
小巧：框架小于150K,并且只是普通的java jar（没有CPU相关的本地部分）减少构建时间避免超出 65k方法数限制
快速：可能是全球最快的Android平台ORM框架，得益于gradle插件，框架能够自动智能执行代码生成
安全且人性化的查询API：QueryBuilder使用属性常量，避免拼写错误（这是SQL语句拼接查询常见的错误）
强大的连接：跨实体的查询，甚至嵌套复杂的多表链接和多条件关系查询
灵活的属性类型：在实体中使用自定义的类或枚举表示数据
加密：支持SQLCipher加密数据库
活跃的社区:超过7000 GitHub stars

在项目中使用GreenDAO#

greenDAO 在 Maven 仓库可用. 请保证点击以下链接检查你使用的是否是最新版本greenDAO最新版链接 | greenDAO-generator最新版链接

添加以下的Gradle配置到安卓项目：

1
// 在项目根目录的 build.gradle 文件:
2
buildscript {
3
    repositories {
4
        jcenter()
5
        mavenCentral() <-- 添加这个仓库
6
    }
7
    dependencies {
8
        classpath 'com.android.tools.build:gradle:2.3.0'
9
        classpath 'org.greenrobot:greendao-gradle-plugin:3.2.1' <-- 添加greendao用到的gradle插件，用于生成GreenDao用到的代码（注意使用最新版本）
10
    }
11
}
12

13
// 在app 项目的 build.gradle 文件:
14
apply plugin: 'com.android.application'
15
apply plugin: 'org.greenrobot.greendao' <-- 应用greendao的gradle插件(用于生成GreenDao用到的代码)
16
//------------
17
//(可选)配置数据库版本，生成的Dao包路径(无特殊要求除了schemaVersion，daoPackage和targetGenDir一般不用配置，使用默认的)
18
greendao {
19
    schemaVersion 1
20
    daoPackage 'com.example.greendao'
21
    targetGenDir 'src/main/java'
22
}
23

24
//------------
25

26
dependencies {
27
    compile 'org.greenrobot:greendao:3.2.0' <-- 添加greenDao框架依赖
28
//如果需要数据库加密，要引入一下sqlcipher加密库
29
//compile 'net.zetetic:android-database-sqlcipher:3.5.4'
30
}

展开收起

注意这些配置使得GreenDao插件在Gradle构建过程中触发，当项目构建时.插件生成 DaoMaster, DaoSession 以及实体类对应的DAO.这些类是GreenDao框架的核心类

声明实体类#

首先，我们声明一个实体类Note,一个自定义的枚举类型NoteType。

1
public enum NoteType {
2
    TEXT, LIST, PICTURE
3
}

1
@Entity
2
public class Note {
3

4
    @Id(autoincrement = true)
5
    private Long id;
6

7
    @NotNull
8
    private String text;
9
    private String comment;
10
    private java.util.Date date;
11

12
    @Convert(converter = NoteTypeConverter.class, columnType = String.class)
13
    private NoteType type;
14

15
    @Generated(hash = 1272611929)
16
    public Note() {
17
    }
18

19
    public Note(Long id) {
20
        this.id = id;
21
    }
22

23
    @Generated(hash = 1686394253)
24
    public Note(Long id, @NotNull String text, String comment, java.util.Date date, NoteType type) {
25
        this.id = id;
26
        this.text = text;
27
        this.comment = comment;
28
        this.date = date;
29
        this.type = type;
30
    }
31

32

33
    @NotNull
34
    public String getText() {
35
        return text;
36
    }
37

38
    /** 非空值声明，保证这个只在保存到数据之前是非空的**/
39
    public void setText(@NotNull String text) {
40
        this.text = text;
41
    }
42

43
    //省略了其他的geter,setter
44

45
}

展开收起

上面的实体类代码中：

@Entity注解表明这是一个GreenDao映射到数据的实体类，括号内的配置是可选的。

@Id注解表明这是主键,autoincrement = true表示自增，注意GreenDao主键需要是Long类型，不能是long或者int之类的其他类型。（这也是安卓推荐的主键类型）

@NotNull 注解表明这是一个非空值，在它的setter参数也注明了非空，保证这个只在保存到数据之前是非空的。

@Convert(converter = NoteTypeConverter.class, columnType = String.class)这个注解实现自定义类型到数据库支持的类型的转换。converter = NoteTypeConverter.class指定转换器是NoteTypeConverter这个类（下面马上介绍），columnType = String.class指定数据库对应的列类型是文本类型。通过Convert我们可以用自然的方式表达各种属性。

@Transient上面的例子没有标出。这个注解表明此字段不存储到数据库中，用于不用持久化的字段

值得说明的是，实体类的构造函数和getter/setter是greendao在项目build的时候自动生成的，是不是很方便呢？

接下来我们再看看转换器的写法。转换器听起来很高级有没有？但是写起来出乎意料的简单。

1
public class NoteTypeConverter implements PropertyConverter<NoteType, String> {
2
    @Override
3
    public NoteType convertToEntityProperty(String databaseValue) {
4
        return NoteType.valueOf(databaseValue);
5
    }
6

7
    @Override
8
    public String convertToDatabaseValue(NoteType entityProperty) {
9
        return entityProperty.name();
10
    }
11
}

每个转换器都实现了PropertyConverter<P, D> 这个接口。P是实体类中自定义的类型，D是数据库支持的类型。

接口方法convertToEntityProperty接受一个数据库支持类型的参数，返回实体类中自定义的类型。

接口方法convertToDatabaseValue接受一个实体类中自定义的类型的参数，返回数据库支持类型。

通过实现这两个方法，我们就完成了实体类的自定义类型到数据库支持类型的映射。在本例中，NoteType这个自定义的枚举类型得以用文本方式存储到数据库。

在Application中配置DaoSession#

接着，我们在App中配置DaoSession，作为数据统一操作的对象，注意DaoSession所在的包如果未配置，默认跟声明的实体类包名相同

1
public class App extends Application {
2
    /**是否加密标志。通过这个例子展示给我们greendao从用SQLCipher加密数据库到标准的sqlite切换时多么简单.打开数据库加密需要引入SQLCipher相关的库*/
3
    public static final boolean ENCRYPTED = false;
4
    /**全局公用的DaoSession**/
5
    private DaoSession daoSession;
6

7
    @Override
8
    public void onCreate() {
9
        super.onCreate();
10
        //DevOpenHelper简单的在数据库需要升级的时候重建数据表，在实际项目中，如果我们需要保存旧版本的数据，需要自己实现一个OpenHelper,把旧版本数据迁移到新版本中。
11

12
        DevOpenHelper helper = new DevOpenHelper(this, ENCRYPTED ? "notes-db-encrypted" : "notes-db");
13
        Database db = ENCRYPTED ? helper.getEncryptedWritableDb("super-secret") : helper.getWritableDb();
14
        daoSession = new DaoMaster(db).newSession();
15
    }
16

17
    public DaoSession getDaoSession() {
18
        return daoSession;
19
    }
20
}

展开收起

** 提醒 ** 记得在AndroidManifest.xml中配置App.

1
    <application
2
        android:name=".App">
3
    </application>

到这里，我们从实体类的声明，数据库操作入口都已经建立好了。没有写一行SQL，是不是有一种畅快淋漓的感觉？下面我们用几个代码片段展示一下如何通过greendao进行数据的增删改查。

查询所有的note列表#

1
        // 获得note对应的DAO。Dao在build的时候自动生成
2
        DaoSession daoSession = ((App) getApplication()).getDaoSession();
3
        //我们通过这个noteDao进行增删改查的操作
4
        NoteDao noteDao = daoSession.getNoteDao();
5

6
        //查询所有的note数据
7
        List<Note> notes = noteDao.loadAll();
8
        // 查询所有的note数据, 根据note的文本内容根据a-z升序排序.这里的NoteDao.Properties.Text是greendao自动生成的，上面提到的属性常量。
9
        notes = noteDao.queryBuilder().orderAsc(NoteDao.Properties.Text).build().list();

根据id来查询一个note记录,修改后再保存到数据库里#

1
        Long id = 1L;
2
        Note note = noteDao.load(id);
3

4
        note.setText("这是修改后的内容文本");
5
        note.setComment("这是修改后的comment");
6
        noteDao.save(note);

删除所有note记录#

1
        noteDao.deleteAll();

根据id删除一条note记录#

1
        Long id = 1;
2
        noteDao.deleteByKey(id);

添加一条note记录#

1
        Note note = new Note();
2
        note.setText("这是note 内容文本");
3
        note.setComment("这是note的comment");
4
        note.setDate(new Date());
5
        note.setType(NoteType.TEXT);
6
        noteDao.insert(note);

后记#

greenDao的简单介绍就到这里。后续介绍GreenDao的进阶使用，包括@ToOne 一对一， @ToMany 一对多等使用介绍。同时介绍如何在现有项目中迁移到GreenDao，包括用统一的数据库管理类来对GreenDao进行轻度封装等。

如何快速搭建模拟接口服务

Fri, 03 Mar 2017 09:30:55 GMT

相信大家在移动APP开发中，无论是做安卓还是iOS开发，都会遇到一个很尴尬的问题,接口没有开发好。而请求网络接口数据是开发中开发流程的第一步，因此方便快捷的模拟接口返回数据给APP，有助于提高开发效率。

下面介绍2个工具来搭建模拟接口服务器。

moco
ngrok

moco#

在过去，我们通常部署一个war包到应用服务器，如Jetty或Tomcat等。我们都知道，开发一个war包然后部署到应用程序服务器太无聊，即使我们使用内嵌服务器，只要我们改变一点点，war包就要重新部署。

moco是一款开源的专注于模拟接口数据的开源工具。它有以下优势：

使用简单：提供下载一个jar文件外加简单的json配置就可运行的方式
配置灵活：可以用独立jar包加载json方式配置，也可以写java代码配置
高度可配置：可以对url，参数,请求方法，返回内容等进行配置
扩展强大：HTTPS，Socket，JUnit 集成，Maven 插件，Gradle 插件，Shell，Scala，满足你不同爱好

例子#

下载 moco独立运行程序
新建moco配置文件如下(foo.json):

1
[
2
  {
3
    "response" :
4
      {
5
        "text" : "Hello, Moco"
6
      }
7
  }
8
]

使用配置文件运行moco独立运行文件.

Terminal window

1
java -jar moco-runner-<version>-standalone.jar http -p 12306 -c foo.json

现在，打开浏览器访问 http://localhost:12306 ，你会看见配置的返回内容”Hello, Moco”

更多使用方法，请参考moco的github说明文档

ngrok#

如果是个人开发，一个简单灵活的接口服务器就已经搭建成功了。APP只要把上文的localhost换成运行moco电脑的IP就能请求到模拟的数据。但是，手机和电脑需要同一个局域网。如果是团队开发，或者手机和电脑不在同一个局域网怎么办？ngrok就是用来解决这个问题的。

ngrok提供了一个能够在公网安全访问内网Web主机的工具，能捕获所有HTTP请求的内容，也支持TCP端口映射，支持Linux、Windows、Mac OS X 等平台。

注意 ngrok V1.X的版本是可以免费支持将一个固定的二级域名指向本机的，不过作者已经把 V2.X的版本商业化,我们使用一个国内免费提供的服务。网址 http://qydev.com

下载windows/linux/mac版本的客户端，解压到你喜欢的目录
在命令行下进入到解压目录下
执行 ngrok -config=ngrok.cfg -subdomain xxx 12306 //(xxx 是你自定义的域名前缀,12306是moco的端口)
如果开启成功你就可以使用 xxx.tunnel.qydev.com 来访问你本机的 127.0.0.1:12306的服务啦

小技巧#

打开 http://127.0.0.1:4040 可以查看ngrok访问情况。

在linux下，ngrok 不能用 & 实现后台运行，我们可以使用使用screen这个命令，步骤如下：

安装screen apt-get install screen 运行 screen -S

任意名字（例如：ngork）然后运行ngrok启动命令

最后按快捷键ctrl+A+D即可保持ngrok后台运行

安卓开发相关框架文章收集（长期更新）

Thu, 01 Jan 1970 00:00:00 GMT

在做项目初期，如果知道有哪些框架/工具可用，对项目的开发会有很大的帮助。这篇帖子收集项目开发用过的，或者有类似需求不知道有对应工具，后来发现这些工具有相见恨晚感觉的。作为一个类似于备忘录的帖子，根据个人判断在需要的时候进行增删改查。介绍时候尽量用一两个关键词。收集的文章可能会因各种原因失效，请以标题自行在搜索引擎搜索。帖子目的不是做到大而全且更新频繁。如果读者有这样的需求，良心推荐干货集中营,每日分享 妹子图 和 ** 技术干货**，还有供大家中午休息的休闲视频

最近更新于 2017-03-24 原文才持续更新哦

工具类#

DiffUtil#

DiffUtil是一个查找集合变化的工具类，是搭配RecyclerView一起使用的。DiffUtil的作用，就是找出集合中每一个Item发生的变化，然后对每个变化给予对应的刷新。 Android开发学习之路-DiffUtil使用教程

logger#

简单，美观，功能强大的安卓打印工具。 GitHub

moco模拟服务器返回数据#

灵活配置参数，请求方法，URL，支持挂载文件，自带独立微型服务器，可以用json，java等语言配置。介绍文章官网

快速开发#

AS插件#

ButterKnife Zelezny：ButterKnife 生成器 SelectorChapek：selector 自动生成XML GsonFormat：json字符串生成相应的实体类介绍文章

bufferKnife#

JakeWharton大神出品。View,资源，事件注解方式初始化。官网

网络框架#

Volley#

2013年Google I/O大会上推出的一个新的网络通信框架，简化Http通信，提供异步回调。个人更推荐使用retrofit`

Retrofit#

Retrofit与okhttp共同出自于Square公司,retrofit就是对okhttp做了一层封装。把网络请求都交给给了Okhttp.配置简单灵活，接口返回对象，支持rxJava无缝对接 GitHub

Glide 图片加载#

这个库被广泛的运用在google的开源项目中，包括2014年google I/O大会上发布的官方app.Glide和Picasso有90%的相似度

Picasso图片加载#

推荐用Glide代替。查看对比文章 Picasso VS Glide

数据库优化#

GreenDAO#

greenDao是一个将对象映射到SQLite数据库中的轻量且快速的ORM解决方案，跟EvenBus师出同门。介绍文章1 介绍文章2 官网

sqlbrite#

square出品。一个轻量级SQLiteOpenHelper包装类，引入reactive 流式语法,完美解决数据库和UI的同步更新！ GitHub

性能优化#

Hugo 打印方法参数执行时间#

JakeWharton大神出品。只要一行@DebugLog注解打印方法的传参和返回值，甚至方法的执行时间,只在debug版本打印，对release版本无任何影响。 GitHub

Scalpel#

JakeWharton大神出品。查看界面层级，3D的效果。方便优化界面布局。 GitHub

leakcanary#

square出品。内存泄漏检测工具 GitHub

rxJava/rxAndroid#

rxJava/rxAndroid 精品文章#

RxJava Essentials 中文翻译版给 Android 开发者的 RxJava 详解深入浅出RxJava（一：基础篇） RxJava 和 RxAndroid 五（线程调度

rxJava 示例代码#

rxJava 示例代码集

rxJava框架 rxBinding#

架构#

精品文章#

Android架构探索

红队渗透测试攻防学习工具分析研究资料汇总

Thu, 01 Jan 1970 00:00:00 GMT

title: 红队渗透测试攻防学习工具分析研究资料汇总 date: 2022-4-25 17:30:55 categories: - 安全

tags: - 安全 - 攻防 - 资料

清单#

https://www.jianshu.com/p/852e0fbe2f4c 安全产品厂商分类 https://www.reddit.com/r/Python/comments/a81mg3/the_entire_mit_intro_computer_science_class_using/ 麻省理工机器学习视频 https://github.com/fxsjy/jieba py，结巴中文分词 https://github.com/thunlp/THULAC-Python py，清华中文分词 https://github.com/lancopku/PKUSeg-python py3，北大中文分词 https://github.com/fengdu78/Coursera-ML-AndrewNg-Notes 吴恩达机器学习 python 笔记 https://paperswithcode.com/sota 机器学习具体项目、演示、代码 https://github.com/duoergun0729/nlp 一本开源的 NLP（神经语言程序学）入门书籍 https://www.freebuf.com/articles/web/195304.html 一句话木马的套路

攻防测试手册#

内网安全文档#

https://attack.mitre.org/wiki/Lateral_Movement mitre 机构对横向移动的总结 https://payloads.online/archivers/2018-11-30/1 彻底理解 Windows 认证 – 议题解读 https://github.com/klionsec/klionsec.github.io 内网大牛的学习历程 https://github.com/l3m0n/pentest_study 从零开始内网渗透学习 https://github.com/Ridter/Intranet_Penetration_Tips 内网渗透 TIPS

学习手册相关资源#

https://github.com/HarmJ0y/CheatSheets 多个项目的速查手册（Beacon / Cobalt Strike，PowerView，PowerUp，Empire 和 PowerSploit） https://wizardforcel.gitbooks.io/kali-linux-web-pentest-cookbook/content/ Kali Linux Web 渗透测试秘籍中文版 https://github.com/louchaooo/kali-tools-zh kali 下工具使用介绍手册 https://www.offensive-security.com/metasploit-unleashed/ kali 出的 metasploit 指导笔记 http://www.hackingarticles.in/comprehensive-guide-on-hydra-a-brute-forcing-tool/ hydra 使用手册 https://www.gitbook.com/book/t0data/burpsuite/details burpsuite 实战指南 https://zhuanlan.zhihu.com/p/26618074 Nmap 扩展脚本使用方法 https://somdev.me/21-things-xss/ XSS 的 21 个扩展用途 https://www.netsparker.com/blog/web-security/sql-injection-cheat-sheet/ sql 注入 sheet 表 https://sqlwiki.netspi.com/ 你要的 sql 注入知识点都能找到 https://github.com/kevins1022/SQLInjectionWiki 一个专注于聚合和记录各种 SQL 注入方法的 wiki https://github.com/hardenedlinux/linux-exploit-development-tutorial Linux exploit 开发入门 https://wizardforcel.gitbooks.io/asani/content 浅入浅出 Android 安全中文版 https://wizardforcel.gitbooks.io/lpad/content Android 渗透测试学习手册中文版 https://github.com/writeups/ios ios 漏洞 writeup 笔记 http://blog.safebuff.com/2016/07/03/SSRF-Tips/ ssrf 漏洞利用手册

Checklist 和基础安全知识#

https://book.yunzhan365.com/umta/rtnp/mobile/index.html 网络安全科普小册子 http://sec.cuc.edu.cn/huangwei/textbook/ns/ 网络安全电子版教材。中传信安课程网站 https://mitre.github.io/attack-navigator/enterprise/ mitre 机构 att&ck 入侵检测条目 https://github.com/danielmiessler/SecLists 表类型包括用户名，密码，URL，敏感数据模式，模糊测试负载，Web shell 等 https://github.com/GitGuardian/APISecurityBestPractices api 接口测试 checklist https://github.com/ym2011/SecurityManagement 分享在建设安全管理体系、ISO27001、等级保护、安全评审过程中的点点滴滴 https://mp.weixin.qq.com/s/O36e0gl4cs0ErQPsb5L68Q 区块链，以太坊智能合约审计 CheckList https://github.com/slowmist/eos-bp-nodes-security-checklist 区块链，EOS bp nodes security checklist（EOS 超级节点安全执行指南） https://xz.aliyun.com/t/2089 金融科技 SDL 安全设计 checklist https://github.com/juliocesarfort/public-pentesting-reports 由几家咨询公司和学术安全组织发布的公共渗透测试报告的列表。 http://www.freebuf.com/articles/network/169632.html 开源软件创建 SOC 的一份清单 https://github.com/0xRadi/OWASP-Web-Checklist owasp 网站检查条目 https://www.securitypaper.org/ SDL 开发安全生命周期管理 https://github.com/Jsitech/JShielder linux 下服务器一键加固脚本 https://github.com/wstart/DB_BaseLine 数据库基线检查工具

产品设计文档#

https://www.freebuf.com/sectool/135032.html 构建一个高交互型的难以发现的蜜罐 https://bloodzer0.github.io/ossa/ 利用开源文件进行开源安全架构.主机、扫描器、端口、日志、防护设备等 https://github.com/dvf/blockchain 用 Python 从零开始创建区块链 https://github.com/crazywa1ker/DarthSidious-Chinese 从 0 开始你的域渗透之旅，DarthSidious 中文版 https://paper.seebug.org/772/ 如何使用 KittyFuzzer 结合 ISF 中的工控协议组件对工控协议进行 Fuzz

学习靶场#

https://www.blackmoreops.com/2018/11/06/124-legal-hacking-websites-to-practice-and-learn/ 124 个合法的可以练习 Hacking 技术的网站 https://www.zhihu.com/question/267204109 学 web 安全去哪里找各种各样的靶场？ https://www.vulnhub.com 许多 ctf 靶机汇总 https://www.wechall.net 世界知名 ctf 汇总交流网站 https://www.xssgame.com 谷歌 XSS 挑战 http://xss.tv 在线靶场挑战 https://www.hackthebox.eu 在线靶场挑战 https://www.root-me.org 在线靶场挑战 http://www.itsecgames.com bWAPP，包含 100 多种漏洞环境 https://github.com/c0ny1/vulstudy 多种漏洞复现系统的 docker 汇总 https://github.com/bkimminich/juice-shop 常见 web 安全实验靶场市场 https://github.com/ethicalhack3r/DVWA web 安全实验靶场 https://www.freebuf.com/articles/web/123779.html 新手指南：DVWA-1.9 全级别教程 https://github.com/78778443/permeate php，常见漏洞靶场 https://github.com/gh0stkey/DoraBox php,常见漏洞靶场 https://github.com/stamparm/DSVW py2,常见漏洞靶场 https://github.com/amolnaik4/bodhi py,常见漏洞靶场 https://github.com/Safflower/Solve-Me php，韩国一个偏代码审计的 ctf 靶场源码 https://github.com/WebGoat/WebGoat 一键 jar 包，web 安全实验靶场 https://github.com/Audi-1/sqli-labs 基于 SQLite 的 sql 注入学习靶场 https://github.com/lcamry/sqli-labs 通过 sqli-labs 演示 mysql 相关的注入手法 https://github.com/c0ny1/upload-labs 一个帮你总结所有类型的上传漏洞的靶场 https://github.com/LandGrey/upload-labs-writeup upload-labs 指导手册 https://github.com/Go0s/LFIboomCTF 本地文件包含漏洞&&PHP 利用协议&&实践源码 https://in.security/lin-security-practise-your-linux-privilege-escalation-foo/ 一个虚拟机文件用于 linux 提权练习 https://github.com/OWASP/igoat 适用于 ios 应用程序测试和安全性的学习工具 https://github.com/prateek147/DVIA-v2 适用于 ios 应用程序测试和安全性的学习工具 https://github.com/rapid7/metasploitable3 metasploit 练习系统 https://github.com/rapid7/metasploit-vulnerability-emulator 基于 perl 的 metasploit 模拟环境，练习操作 https://github.com/chryzsh/DarthSidious AD 域环境的搭建、渗透、防护 https://github.com/c0ny1/xxe-lab 一个包含 php,java,python,C#等各种语言版本的 XXE 漏洞 Demo

漏洞复现#

https://github.com/vulhub/vulhub Vulhub 是一个面向大众的开源漏洞靶场，无需 docker 知识，执行两条命令即可编译、运行一个完整的漏洞靶场镜像 https://github.com/Medicean/VulApps 收集各种漏洞环境，为方便使用，统一采用 Dockerfile 形式。同时也收集了安全工具环境。 https://github.com/bingohuang/docker-labs 制作在线 docker 平台

开源漏洞库#

https://wooyun.kieran.top/#!/ 2016 年之前，乌云 Drops 文章，公开漏洞详情文章 https://wooyun.js.org/ 2016 年之前，乌云 Drops 文章，公开漏洞详情文章 https://dvpnet.io/list/index/state/3 公开漏洞详情文章 https://sec.ly.com/bugs 同程安全公开漏洞详情文章 http://ics.cnvd.org.cn 中国国家工控漏洞库 https://ics-cert.us-cert.gov/advisories 美国国家工控漏洞库 http://www.nsfocus.net/index.php?act=sec_bug 绿盟漏洞库，含工控 http://ivd.winicssec.com/ 威努特工控漏洞库 http://cve.scap.org.cn/view/ics CVE 中文工控漏洞库 https://cve.mitre.org/cve/search_cve_list.html 美国 MITRE 公司负责维护的 CVE 漏洞库 https://www.exploit-db.com 美国 Offensive Security 的漏洞库 https://nvd.nist.gov/vuln/search 美国国家信息安全漏洞库

工具包集合#

http://www.4hou.com/web/11241.html 史上最全攻击模拟工具盘点 https://github.com/infosecn1nja/Red-Teaming-Toolkit 信息收集、攻击尝试获得权限、持久性控制、权限提升、网络信息收集、横向移动、数据分析（在这个基础上再做持久化控制）、清理痕迹 https://github.com/toolswatch/blackhat-arsenal-tools 黑帽大会工具集 https://www.cnblogs.com/k8gege K8 哥哥工具包集合。解压密码 Kk8team,Kk8gege https://github.com/n00py/ReadingList/blob/master/gunsafe.txt 安全工具集 https://github.com/Ridter/Pentest 安全工具集 https://github.com/redcanaryco/atomic-red-team win、linux、mac 等多方面 apt 利用手段、技术与工具集 https://github.com/Cooolis/Cooolis.github.io Cooolis 是一个操作系统命令技巧备忘录，https://cooolis.payloads.online https://github.com/LOLBAS-Project/LOLBAS 常见的渗透测试利用的脚本与二进制文件集合 https://www.owasp.org/index.php/File:CSRFTester-1.0.zip csrf 验证工具 https://github.com/ufrisk/MemProcFS 以访问文件系统的方式访问物理内存, 可读写, 有易于使用的接口. 当前支持 Windows https://github.com/vletoux/SpoolerScanner 检测 Windows 远程打印机服务是否开启的工具 https://github.com/sirpsycho/firecall 直接向 CiscoASA 防火墙发送命令, 无需登录防火墙后再做修改 https://github.com/jboss-javassist/javassist 能够操作字节码框架，通过它我们能很轻易的修改 class 代码文件 https://github.com/ConsenSys/mythril-classic 用于以太坊智能协议的安全分析工具 https://github.com/a13xp0p0v/kconfig-hardened-check 用于检查 Linux 内核配置中的安全加固选项的脚本 https://github.com/lionsoul2014/ip2region ip 地址定位库，支持 python3 等多接口。类比 geoip https://github.com/m101/hsploit 基于 rust 的 HEVD 漏洞利用程序 https://github.com/ticarpi/jwt_tool 针对 json web token 的检测 https://github.com/clr2of8/DPAT 域密码配置审计 https://github.com/chenjj/CORScanner 域解析漏洞，跨域扫描器 https://github.com/dienuet/crossdomain 域解析漏洞，跨域扫描器 https://github.com/sfan5/fi6s ipv6 端口快速扫描器 https://github.com/lavalamp-/ipv666 go,ipv6 地址枚举扫描 https://github.com/commixproject/commix 命令注入漏洞扫描 https://github.com/Graph-X/davscan DAVScan 是一款快速轻便的 webdav 扫描仪，旨在发现 DAV 启用的 Web 服务器上的隐藏文件和文件夹 https://github.com/jcesarstef/dotdotslash 目录遍历漏洞测试 https://github.com/P3GLEG/WhaleTail 根据 docker 镜像生成成 dockerfile https://github.com/cr0hn/dockerscan docker 扫描工具 https://github.com/utiso/dorkbot 通过定制化的谷歌搜索引擎进行漏洞页面搜寻及扫描 https://github.com/NullArray/DorkNet 基于搜索引擎的漏洞网页搜寻 https://github.com/panda-re/lava 大规模向程序中植入恶意程序 https://github.com/woj-ciech/Danger-zone 关联域名、IP 和电子邮件地址之间的数据并将其可视化输出 https://github.com/securemode/DefenderKeys 枚举出被 Windows Defender 排除扫描的配置 https://github.com/D4Vinci/PasteJacker 剪贴板劫持利用工具 https://github.com/JusticeRage/freedomfighting 日志清理、文件共享、反向 shell、简单爬虫工具包 https://github.com/gh0stkey/PoCBox 漏洞测试验证辅助平台，SONP 劫持、CORS、Flash 跨域资源读取、Google Hack 语法生成、URL 测试字典生成、JavaScript URL 跳转、302 URL 跳转 https://github.com/jakubroztocil/httpie http 调试工具，类似 curl，功能更完善 https://www.getpostman.com/ http 调试工具，带界面

漏洞收集与 Exp、Poc 利用#

https://github.com/Lcys/Python_PoC python3 的 poc、exp 快速编写模板，有众多模范版本 https://github.com/raminfp/linux_exploit_development linux 漏洞利用开发手册 https://github.com/mudongliang/LinuxFlaw 包含 linux 下软件漏洞列表 https://github.com/coffeehb/Some-PoC-oR-ExP 各种漏洞 poc、Exp 的收集或编写 https://github.com/userlandkernel/plataoplomo Sem Voigtländer 公开其发现的 iOS 中各种漏洞，包括（Writeup/POC/Exploit） https://github.com/coffeehb/Some-PoC-oR-ExP/blob/master/check_icmp_dos.py CVE-2018-4407，macos/ios 缓冲区溢出可导致系统崩溃 https://github.com/vulnersCom/getsploit py2,仿照 searchsploit 通过各种数据库的官方接口进行 payload 的查找 https://github.com/SecWiki/CMS-Hunter CMS 漏洞测试用例集合 https://github.com/Mr5m1th/0day 各种开源 CMS 各种版本的漏洞以及 EXP https://github.com/w1109790800/penetration CMS 新老版本 exp 与系统漏洞搜集表 https://github.com/blacknbunny/libSSH-Authentication-Bypass CVE-2018-10933，libssh 服务端身份验证绕过 https://github.com/leapsecurity/libssh-scanner CVE-2018-10933，libssh 服务端身份验证绕过 https://github.com/anbai-inc/CVE-2018-4878 Adobe Flash Exploit 生成 payload https://github.com/RetireJS/grunt-retire 扫描 js 扩展库的常见漏洞 https://github.com/coffeehb/SSTIF 服务器端模板注入漏洞的半自动化工具 https://github.com/tijme/angularjs-csti-scanner 探测客户端 AngularJS 模板注入漏洞工具 https://github.com/blackye/Jenkins Jenkins 漏洞探测、用户抓取爆破 https://github.com/epinna/tplmap 服务器端模板注入漏洞检测与利用工具 https://github.com/irsdl/IIS-ShortName-Scanner Java,IIS 短文件名暴力枚举漏洞利用工具 https://github.com/lijiejie/IIS_shortname_Scanner py2,IIS 短文件名漏洞扫描 https://github.com/rudSarkar/crlf-injector CRLF 注入漏洞批量扫描 https://github.com/hahwul/a2sv SSL 漏洞扫描，例如心脏滴血漏洞等 https://github.com/jagracey/Regex-DoS RegEx 拒绝服务扫描器 https://github.com/Bo0oM/PHP_imap_open_exploit 利用 imap_open 绕过 php exec 函数禁用 https://www.anquanke.com/post/id/106488 利用 mysql 服务端恶意配置读取客户端文件，（如何利用 MySQL LOCAL INFILE 读取客户端文件，Read MySQL Client’s File，【技术分享】从 MySQL 出发的反击之路） https://www.waitalone.cn/awvs-poc.html CVE-2015-4027，AWVS10 命令执行漏洞 http://an7isec.blogspot.com/2014/04/pown-noobs-acunetix-0day.html Pwn the n00bs – Acunetix 0day，awvs8 命令执行漏洞 https://github.com/numpy/numpy/issues/12759 科学计算框架 numpy 命令执行 RCE 漏洞 https://github.com/petercunha/Jenkins-PreAuth-RCE-PoC jenkins 远程命令执行 https://github.com/WyAtu/CVE-2018-20250 WinRar 执行漏洞加使用介绍

物联网路由工控漏洞收集#

https://github.com/yassineaboukir/CVE-2018-0296 测试思科 ASA 路径穿越漏洞，可获取系统详细信息 https://github.com/seclab-ucr/tcp_exploit 利用 tcp 漏洞使无线路由器产生隐私泄露 https://github.com/ezelf/CVE-2018-9995_dvr_credentials CVE-2018-9995 摄像头路由，Get DVR Credentials

Java 反序列化漏洞收集#

https://github.com/brianwrf/hackUtils java 反序列化利用 https://github.com/GoSecure/break-fast-serial 借助 DNS 解析来检测 Java 反序列化漏洞工具 https://github.com/s1kr10s/Apache-Struts-v3 Apache-Struts 漏洞利用工具 https://github.com/iBearcat/S2-057 struts2 CVE-2018-11776 漏洞检测工具 https://github.com/Ivan1ee/struts2-057-exp struts2-057 利用脚本 https://github.com/theLSA/s2sniper struts2 漏洞的检测工具 https://github.com/Lucifer1993/struts-scan 批量检测 struts 命令执行漏洞 https://github.com/lijiejie/struts2_045_scan Struts2-045 漏洞批量扫描工具 https://github.com/riusksk/StrutScan 基于 perl 的 strut2 的历史漏洞扫描 https://github.com/Coalfire-Research/java-deserialization-exploits java 反序列化漏洞收集 https://github.com/quentinhardy/jndiat weblogic 漏洞利用工具 https://github.com/jas502n/CVE-2018-3191 Weblogic CVE-2018-3191 远程代码命令执行 https://github.com/pyn3rd/CVE-2018-3245 weblogic cve-2018-2893 与 cve-2018-3245 远程代码命令执行 https://github.com/NickstaDB/BaRMIe 用于 Java Remote Method Invocation 服务的工具/rmi 的枚举与远程命令执行 https://github.com/joaomatosf/jexboss JBoss 和其他 java 序列化漏洞验证和开发工具 https://github.com/frohoff/ysoserial java 反序列化利用工具

版本管理平台漏洞收集#

https://github.com/shengqi158/svnhack .svn 文件夹泄漏利用工具 https://www.waitalone.cn/seay-svn-poc-donw-20140505.html Seay-Svn 源代码泄露漏洞利用工具，2014-05-05 版 https://github.com/BugScanTeam/GitHack .git 文件利用工具，lijiejie 改进版 https://github.com/lijiejie/GitHack .git 文件利用工具

MS 与 Office 漏洞收集#

https://github.com/Lz1y/CVE-2017-8759 .NET Framework 换行符漏洞，CVE-2017-8759 完美复现（另附加 hta+powershell 弹框闪烁解决方案）https://www.freebuf.com/vuls/147793.html https://github.com/WyAtu/CVE-2018-8581 Exchange 使用完成添加收信规则的操作进行横向渗透和提权漏洞 https://github.com/dafthack/MailSniper PS,用于在 Microsoft Exchange 环境搜索电子邮件查找特定邮件（密码、网络架构信息等） https://github.com/sensepost/ruler GO,通过 MAPI / HTTP 或 RPC / HTTP 协议远程与 Exchange 服务器进行交互,通过客户端 Outlook 功能远程获取 shell https://github.com/3gstudent/Smbtouch-Scanner 扫描内网永恒之蓝 ETERNAL445SMB 系列漏洞 https://github.com/smgorelik/Windows-RCE-exploits windows 命令执行 RCE 漏洞 POC 样本，分为 web 与文件两种形式 https://github.com/3gstudent/CVE-2017-8464-EXP CVE-2017-8464，win 快捷方式远程执行漏洞 https://github.com/Lz1y/CVE-2018-8420 Windows 的 msxml 解析器漏洞可以通过 ie 或 vbs 执行后门 https://www.anquanke.com/post/id/163000 利用 Excel 4.0 宏躲避杀软检测的攻击技术分析 https://github.com/BuffaloWill/oxml_xxe XXE 漏洞利用 https://thief.one/2017/06/20/1/ 浅谈 XXE 漏洞攻击与防御 https://github.com/thom-s/docx-embeddedhtml-injection word2016，滥用 Word 联机视频特征执行恶意代码 poc https://blog.cymulate.com/abusing-microsoft-office-online-video word2016，滥用 Word 联机视频特征执行恶意代码介绍 https://github.com/0xdeadbeefJERKY/Office-DDE-Payloads 无需开启宏即可在 word 文档中利用 DDE 执行命令 http://www.freebuf.com/articles/terminal/150285.html 无需开启宏即可在 word 文档中利用 DDE 执行命令利用 https://github.com/Ridter/CVE-2017-11882 利用 word 文档 RTF 获取 shell，https://evi1cg.me/archives/CVE_2017_11882_exp.html https://github.com/Lz1y/CVE-2017-8759 利用 word 文档 hta 获取 shell，http://www.freebuf.com/vuls/147793.html https://fuping.site/2017/04/18/CVE-2017-0199 漏洞复现过程 WORD RTF 文档，配合 msf 利用 https://github.com/tezukanice/Office8570 利用 ppsx 幻灯片远程命令执行，https://github.com/rxwx/CVE-2017-8570 https://github.com/0x09AL/CVE-2018-8174-msf 目前支持的版本是 32 位 IE 浏览器和 32 位 office。网页访问上线，浏览器关闭，shell 依然存活，http://www.freebuf.com/vuls/173727.html http://www.4hou.com/technology/9405.html 在 Office 文档的属性中隐藏攻击载荷 https://evi1cg.me/archives/Create_PPSX.html 构造 PPSX 钓鱼文件 https://github.com/enigma0x3/Generate-Macro PowerShell 脚本，生成含有恶意宏的 Microsoft Office 文档 https://github.com/mwrlabs/wePWNise 生成独立于体系结构的 VBA 代码，用于 Office 文档或模板，并自动绕过应用程序控制 https://github.com/curi0usJack/luckystrike 基于 ps，用于创建恶意的 Office 宏文档 https://github.com/sevagas/macro_pack MS Office 文档、VBS 格式、快捷方式 payload 捆绑 https://github.com/khr0x40sh/MacroShop 一组通过 Office 宏传递有效载荷的脚本

Kali 环境下拓展插件#

https://github.com/secforce/sparta py，图形化应用程序联动 Nmap、Nikto、Hydra 等工具 https://github.com/Manisso/fsociety linux 下类似于 kali 的工具包一键安装工具 https://github.com/LionSec/katoolin 使用 linux 服务器自动安装 kali 工具包 https://github.com/skavngr/rapidscan py2，simple，联动 kali 下工具，漏洞扫描工具 https://github.com/koenbuyens/kalirouter 将 kali 设置为一个路由流量分析系统

Nessus 相关工具拓展插件#

https://www.tenable.com/downloads/nessus https://github.com/se55i0n/Awvs_Nessus_Scanner_API 扫描器 Awvs 11 和 Nessus 7 Api 利用脚本 https://github.com/DanMcInerney/msf-autoshell 配合 nessus 扫描结果进行 msf 攻击 https://github.com/MooseDojo/apt2 联动 nmap、nessus 等工具进行安全测试

Awvs 相关工具拓展插件#

https://www.52pojie.cn/thread-214819-1-1.html awvs10.5 开发框架破解版 https://github.com/fnmsd/awvs_script_decode awvs10.5 规则 scripts 解密版，SDK，开发手册 https://github.com/NS-Sp4ce/AWVS11.X-Chinese-Version awvs11 汉化包

Burpsuit 相关工具拓展插件#

https://github.com/PortSwigger burpsuite 官方插件库 https://github.com/snoopysecurity/awesome-burp-extensions awesome 系列之 burp 拓展 https://github.com/d3vilbug/HackBar 集成 hackbar https://github.com/PortSwigger/turbo-intruder 比 Burp 自带的 Intruder 更快，一分钟打 1.61 万次请求 https://github.com/Ebryx/AES-Killer burp 插件，破解 aes 加密的插件 https://github.com/bugcrowd/HUNT 可以将 burpsuite 扫描器功能扩展的更加强大，同时支持 zapproxy 扩展 https://github.com/wagiro/BurpBounty burp 插件增强主动与被动扫描功能 https://github.com/nccgroup/BurpSuiteHTTPSmuggler Burp 拓展, 使用几种技巧绕过 WAF https://github.com/PortSwigger/command-injection-attacker burp 插件，命令注入漏洞检测 https://github.com/nccgroup/freddy burp 插件，自动识别 Java/.NET 应用程序中的反序列化漏洞 https://github.com/modzero/interestingFileScanner burp 插件，增强敏感文件扫描 https://github.com/summitt/Burp-Non-HTTP-Extension burp 插件，布置 dns 服务器抓取流量 https://github.com/ilmila/J2EEScan burp 拓展，扫描 J2EE 应用 https://github.com/JGillam/burp-co2 集成了 sqlmap，菜刀，字典生成等 https://github.com/swisskyrepo/SSRFmap burp 插件，检测 ssrf 漏洞

Sqlmap 相关工具拓展插件#

https://github.com/codewatchorg/sqlipy burp 与 sqlmap 联动插件 https://github.com/Hood3dRob1n/SQLMAP-Web-GUI sqlmap 的 web gui https://github.com/KINGSABRI/sqlmap-tamper-api 利用各种语言来编写 sqlmapTamper https://github.com/0xbug/SQLiScanner 一款基于 sqlmapapi 和 Charles 的被动 SQL 注入漏洞扫描工具 https://github.com/fengxuangit/Fox-scan 基于 sqlmapapi 的主动和被动资源发现的漏洞扫描工具 https://github.com/UltimateHackers/sqlmate 在 sqlmap 基础上增加了目录扫描、hash 爆破等功能 https://github.com/ysrc/GourdScanV2 ysrc 出品的被动式漏洞扫描工具，基于 sqlmapapi https://github.com/zt2/sqli-hunter 基于 sqlmapapi，ruby 编写的漏洞代理型检测工具 https://github.com/jesuiscamille/AutoSQLi 利用 DorkNet，Googler, Ddgr, WhatWaf 和 sqlmap 自动注入

Nmap 相关工具拓展插件#

https://github.com/Ullaakut/nmap GO，实现的 Nmap 调用库 https://github.com/cldrn/nmap-nse-scripts NSE 收集列表 https://github.com/vulnersCom/nmap-vulners 使用 nmap 扫描常见的服务漏洞 https://github.com/s4n7h0/Halcyon Nmap Script (NSE)IDE 编辑器 https://github.com/m4ll0k/AutoNSE NSE 自动化利用 https://github.com/Screetsec/Dracnmap shell，将 Nmap 复杂的命令进行一定程度的集成与简化，使新用户更加容易上手。 https://github.com/cldrn/rainmap-lite Django，Web 版 Nmap，可以建立新的扫描服务器，允许用户从他们的手机/平板电脑/网络浏览器启动 Nmap 扫描 https://github.com/trimstray/sandmap linux 下将支持使用大量 Nmap 引擎进行网络和系统侦察的工具 https://github.com/m0nad/HellRaiser 基于 nmap 的扫描器，与 cve 漏洞关联 https://github.com/scipag/vulscan 基于 nmap 的高级漏洞扫描器，命令行环境使用 https://github.com/Rev3rseSecurity/WebMap 将 nmap 的 xml web 展示器 https://github.com/DanMcInerney/msf-autopwn 执行 NMap 扫描或读取扫描结果, 然后自动使用 msf 攻击包含常见漏洞的主机

Metasploit 相关工具拓展插件#

https://github.com/13o-bbr-bbq/machine_learning_security/tree/master/DeepExploit 结合机器学习与 msf 的全自动测试工具 https://github.com/r00t-3xp10it/Meterpreter_Paranoid_Mode-SSL 一个可以创建 SSL/TLS shell 连接的脚本 https://github.com/DanMcInerney/msf-netpwn 等待 msf 的 session，并自动提为域管理 https://www.exploit-db.com/exploits/45851/ msf 插件，利用 jira upm 上传进行命令执行 https://github.com/NullArray/AutoSploit 利用 Shodan 搜索引擎收集目标, 并自动调用设定的 msf 模块对目标发动攻击 https://github.com/WazeHell/metateta 使用 msf 脚本，根据特定协议进行扫描 https://github.com/fbkcs/msf-elf-in-memory-execution Metasploit 模块, 用于在内存中执行 ELF 文件 https://github.com/ElevenPaths/Eternalblue-Doublepulsar-Metasploit metasploit 双星攻击利用文件 https://github.com/darkoperator/Metasploit-Plugins msf 扩展资产搜集与帮助插件 https://github.com/D4Vinci/One-Lin3r metasploit、payload 辅助查询工具 https://github.com/shizzz477/msploitego 将 msf 数据库与 maltego 进行图形化展示 https://github.com/scriptjunkie/msfgui metasploit 的 GUI 界面，话说现在 msf 对 windows 支持也挺好的

CobaltStrike 相关工具拓展插件#

https://mp.weixin.qq.com/s/CEI1XYkq2PZmYsP0DRU7jg 使用 Aggressor 脚本雕饰 Cobalt Strike https://github.com/rsmudge/armitage CobaltStrike 社区版，调用 msf，一对多带界面 https://github.com/anbai-inc/CobaltStrike_Hanization CobaltStrike2.5 汉化版，以 msf 库为基础，3.0 以后改版 https://github.com/rsmudge/cortana-scripts 用于 cs2.x 与 armitage 的可拓展插件，cvs3.x 的为 AggressorScripts https://github.com/harleyQu1nn/AggressorScripts cs3.0 以后的脚本搜集 https://github.com/FortyNorthSecurity/AggressorAssessor cs3.x 自动化攻击脚本集合 https://github.com/Ridter/CS_Chinese_support/ cs3.0 传输信息的汉化插件 https://github.com/verctor/CS_xor64 生成 cobaltstrike 所需的 xor64.bin https://github.com/ryhanson/ExternalC2 一个用于将通信渠道与 Cobalt Strike External C2 服务器集成的库 https://github.com/threatexpress/cs2modrewrite 用于将 Cobalt Strike 配置文件转换为 mod_rewrite 脚本的工具 https://github.com/Mr-Un1k0d3r/CatMyFish 搜索分类域，为 Cobalt Strike beacon C&C 设置白名单域 https://github.com/threatexpress/malleable-c2 利用 jquery 文件进行 C2 通讯，在文件内做了 JS 混淆绕过防火墙 https://github.com/dcsync/pycobalt py3,Python API for Cobalt Strike https://www.cobaltstrike.com/aggressor-script/cobaltstrike.html CobaltStrike 相关插件编写，一对多带界面

Empire 相关工具拓展插件#

https://paper.tuisec.win/detail/f3dce68a0b4baaa 利用 Empire 获取域控权限 https://github.com/EmpireProject/Empire-GUI empire 的 node.js 界面 https://github.com/interference-security/empire-web empire 的 web 界面 https://github.com/byt3bl33d3r/DeathStar py3,调用 Empire RESTful API 自动化获取域管权限的 https://github.com/infosecn1nja/e2modrewrite 用于将 Empire 配置文件转换为 Apache modrewrite 脚本 https://github.com/maxchehab/CSS-Keylogging Chrome 扩展程序和 Express 服务器利用 CSS 的键盘记录功能。 https://github.com/evilcos/cookiehacker Chrome 扩展程序。JavaScript document.cookie / Wireshark Cookie https://github.com/lfzark/cookie-injecting-tools Chrome 扩展，cookie 注入工具包括注入，编辑，添加和删除 cookie

信息搜集#

https://github.com/smicallef/spiderfoot 利用 OSINT 自动化找出对方信息，gui 界面，插件化 https://github.com/Nhoya/gOSINT go，利用 OSINT 自动化搜集信息 https://github.com/laramies/theHarvester 企业被搜索引擎收录敏感资产信息监控脚本：员工邮箱、子域名、Hosts https://github.com/guelfoweb/knock 通过爆破进行子域名获取，可用于查找子域名接管漏洞 https://github.com/aboul3la/Sublist3r 通过搜索引擎与爆破快速子域枚举工具 https://github.com/Ice3man543/subfinder 基于 go 实现的 Sublist3r https://github.com/yanxiu0614/subdomain3 py3、py2 的子域名,IP,CDN 信息等 https://github.com/caffix/amass 基于 go，子域名枚举, 搜索互联网数据源, 使用机器学习猜测子域名 https://github.com/nahamsec/lazyrecon 侦查 reconnaissance 过程自动化脚本, 可自动使用 Sublist3r/certspotter 获取子域名, 调用 nmap/dirsearch 等 https://github.com/s0md3v/ReconDog simple，侦查信息的瑞士军刀 https://github.com/FeeiCN/ESD py3，爆破搜集子域名 https://github.com/alpha1e0/pentestdb 多用途集成化信息搜集工具 https://github.com/se55i0n/PortScanner py2,目标 tcp 端口快速扫描、banner 识别、cdn 检测 https://github.com/lijiejie/subDomainsBrute lijiejie 开发的一款使用广泛的子域名爆破枚举工具 https://github.com/ring04h/wydomain 猪猪侠开发的一款域名收集全面、精准的子域名枚举工具 https://github.com/n4xh4ck5/N4xD0rk 利用搜索引擎来搜集子域名，可以使用西班牙语搜集 https://github.com/vysec/DomLink py2,调用 WHOXY.com，对邮箱和域名进行进一步的搜集 https://github.com/jonluca/Anubis py3.6，子域名爆破与信息搜集 https://github.com/le4f/dnsmaper web 界面，子域名枚举爆破工具以及地图位置标记 https://github.com/thewhiteh4t/seeker 获取高精度地理信息和设备信息的工具 https://github.com/0xbug/orangescan web 界面，的在线子域名信息收集工具 https://github.com/TheRook/subbrute 扫描器中常用的子域名爆破 API 库 https://github.com/We5ter/GSDF 基于谷歌 SSL 透明证书的子域名查询脚本 https://github.com/mandatoryprogrammer/cloudflare_enum 利用 CloudFlare 的 dns 进行子域名枚举 https://github.com/ultrasecurity/webkiller 渗透辅助，py，ip 信息、端口服务指纹、蜜罐探测、bypass cloudflare https://github.com/christophetd/CloudFlair cloudflare 绕过，获取真实 ip，集成 censys https://github.com/exp-db/PythonPool/tree/master/Tools/DomainSeeker 多方式收集目标子域名信息 https://github.com/code-scan/BroDomain 子域名查询 https://github.com/michenriksen/aquatone 子域名枚举、探测工具。可用于子域名接管漏洞探测 https://github.com/chuhades/dnsbrute 基于 go，高效的子域名爆破工具 https://github.com/evilsocket/dnssearch 基于 go，一款子域名爆破工具 https://github.com/OJ/gobuster 基于 go，根据 dns 查询子域名和 web 目录爆破的工具 https://github.com/reconned/domained 可用于子域名收集的一款工具 https://github.com/bit4woo/Teemo 多方式域名收集及枚举工具 https://github.com/swisskyrepo/Subdomino 子域名枚举，端口扫描，服务存活确认 https://github.com/nmalcolm/Inventus 通过爬虫实现的子域名收集工具 https://github.com/alienwithin/OWASP-mth3l3m3nt-framework 渗透辅助，php，exp 搜寻、payload 与 shell 生产、信息搜集 https://github.com/chrismaddalena/ODIN py3，simple，信息搜集与后期漏洞利用 https://github.com/x0day/bannerscan C 段/旁站查询与路径扫描 https://github.com/Xyntax/BingC 基于 Bing 搜索引擎的 C 段/旁站查询，多线程，支持 API https://github.com/zer0h/httpscan 网段 Web 主机发现小工具 https://github.com/lijiejie/BBScan 网站信息泄漏批量扫描脚本 https://github.com/aipengjie/sensitivefilescan 网站敏感文件扫描工具 https://github.com/Mosuan/FileScan 网站敏感文件扫描 / 二次判断降低误报率 / 扫描内容规则化 / 多目录扫描 https://github.com/Xyntax/FileSensor 网站敏感文件探测工具 https://github.com/ring04h/weakfilescan 多线程网站泄露信息检测工具 https://github.com/Viralmaniar/Passhunt simple，用于搜索网络设备 Web 应用程序等的默认凭证。包含 523 个厂家的 2084 组默认密码 https://github.com/yassineaboukir/Asnlookup simple,利用 ASN 搜索特定组织拥有 ip，可联动 nmap、masscan 进行进一步信息扫描

敏感信息泄露发现#

https://github.com/Yelp/detect-secrets PY,防止代码中的密码等相关敏感信息被提交到代码库中，可以在保证安全性的同时不会给开发者的生产力带来任何影响 https://github.com/Acceis/leakScraper 处理和可视化大规模文本文件, 查找敏感信息, 例如证书 https://github.com/Raikia/CredNinja 多线程用户凭证验证脚本，比如验证 dump 的 hash 是否属于此机器，利用 445 端口进行协议验证 https://github.com/CERTCC/keyfinder 查找并分析私钥/公钥文件(文件系统中), 支持 Android APK 文件 https://github.com/Ice3man543/hawkeye go，cli 端，文件系统分析工具，快速查找文件内包含的 SSH 密钥，日志文件，Sqlite 数据库，密码文件等 https://github.com/FortyNorthSecurity/EyeWitness 获取目标网站截图、vnc、rdp 服务，尝试获取默认凭证 https://github.com/D4Vinci/Cr3dOv3r 根据邮箱自动搜索泄漏的密码信息，也可测试账户密码在各大网站能否登录的工具

威胁情报分析#

https://www.databases.today，https://publicdbhost.dmca.gripe/，http://www.wttech.org/，https://hashes.org/leaks.php，https://archive.org/search.php?query= 密码泄露 https://www.threatcrowd.org/ 威胁情报分析平台 https://x.threatbook.cn/ 微步在线 | 威胁情报分析平台-ThreatBook-多引擎在线扫描、恶意软件在线检测 https://github.com/needmorecowbell/sniff-paste 针对 Pastebin 的开源情报收集工具 https://talosintelligence.com/documents/ip-blacklist 恶意 IP 地址 https://ransomwaretracker.abuse.ch/downloads/RW_IPBL.txt 恶意软件 IP 地址 https://check.torproject.org/cgi-bin/TorBulkExitList.py?ip=1.1.1.1 洋葱路由出口节点 https://isc.sans.edu/api/threatlist/shodan shodan 撒旦扫描器节点 https://github.com/Te-k/harpoon 用于开源和威胁智能的 CLI 工具 https://trumail.io/ 验证对方邮箱是否为垃圾邮箱，每个月可以免费验证 1000 次 https://github.com/ChrisJohnRiley/Scythe 验证账号是否为常用账号 https://github.com/fireeye/GeoLogonalyzer 远程身份验证地理位置分析工具，用于区分合法登录和恶意登录。 https://github.com/target/strelka py3，通过实时扫描文件进行威胁情报分析和实时监测。

托管云安全#

https://github.com/stuhirst/awssecurity/blob/master/arsenal.md AWS 安全检测相关的项目列表 https://github.com/toniblyx/my-arsenal-of-aws-security-tools AWS 安全工具集 https://github.com/sa7mon/S3Scanner 扫描 amazon 公开的 S3 buckets 和 dump https://github.com/kromtech/s3-inspector 检测亚马逊 AWS S3 bucket permissions https://github.com/jordanpotti/AWSBucketDump 枚举 AWS S3 buckets 以查找敏感机密的文件 https://github.com/sa7mon/S3Scanner 扫描 amazon 公开的 S3 buckets 和 dump https://github.com/kromtech/s3-inspector 检测亚马逊 AWS S3 bucket permissions https://github.com/jordanpotti/AWSBucketDump 枚举 AWS S3 buckets 以查找敏感机密的文件 https://github.com/Netflix/repokid AWS 最低权限策略部署工具 https://github.com/RhinoSecurityLabs/pacu AWS 漏洞检测框架 https://github.com/0xbug/Hawkeye GitHub 泄露监控系统 https://github.com/neal1991/gshark github 信息泄露检测 https://github.com/VKSRC/Github-Monitor GitHub 监控，代码信息泄露，分钟级监控，邮件预警 https://github.com/metac0rtex/GitHarvester github Repo 信息搜集工具 https://github.com/repoog/GitPrey GitHub 敏感信息扫描工具 https://github.com/FeeiCN/GSIL py3，近实时监控 Github 敏感信息，并发送告警通知。 https://github.com/UnkL4b/GitMiner github 敏感内容挖掘 https://github.com/dxa4481/truffleHog GitHub 敏感信息扫描工具,包括检测 commit 等 https://github.com/Hell0W0rld0/Github-Hunter github 信息监测脚本 https://github.com/awslabs/git-secrets 防止将敏感数据提交到 git 仓库的工具 https://github.com/zricethezav/gitleaks 基于 go 的，检查 git repo 中的密码信息和密钥

目录路径发现#

https://github.com/maurosoria/dirsearch 经典目录路径扫描 https://github.com/TheM4hd1/PenCrawLer C#界面，web 爬虫与目录路径爆破工具，除了常规扫描增加了递归爆破模式 https://github.com/Xyntax/DirBrute 目录路径爆破工具 https://github.com/abaykan/crawlbox 目录路径路径扫描器 https://github.com/deibit/cansina 目录路径路径扫描器 https://github.com/UltimateHackers/Breacher 多线程的后台路径扫描器，也可用于发现 Execution After Redirect 漏洞 https://github.com/fnk0c/cangibrina 通过字典穷举、google、robots.txt 等途径的跨平台后台管理路径扫描器 https://github.com/Go0s/SitePathScan 基于协程的目录路径爆破工具，配合 aiohttp 扫描路径比之前快了三倍有余 https://github.com/secfree/bcrpscan 基于爬虫的 web 路径扫描器

本地文件包含漏洞#

https://github.com/hvqzao/liffy 本地文件包含漏洞利用工具 https://github.com/D35m0nd142/Kadabra 本地文件包含漏洞扫描和利用工具 https://github.com/P0cL4bs/Kadimus 本地文件包含漏洞扫描和利用工具 https://github.com/D35m0nd142/LFISuite 本地文件包含漏洞利用及扫描工具，支持反弹 shell https://github.com/OsandaMalith/LFiFreak 本地文件包含漏洞利用及扫描工具，支持反弹 shell

安全测试与扫描器框架#

https://github.com/zaproxy/zaproxy The OWASP ZAP core project 出品的综合性渗透测试工具。由于其流量代理、请求重放和可扩展性拿来做模糊测试未尝不可 https://github.com/x-Ai/BurpUnlimitedre burpsuite 1.7.27 的永久破解版 https://github.com/andresriancho/w3af 知名插件化扫描器 https://github.com/juansacco/exploitpack 渗透测试集成框架，包含超过 38,000+ exploits https://github.com/Lucifer1993/AngelSword Web 应用漏洞扫描框架,python3，300poc https://github.com/Xyntax/POC-T 渗透测试插件化扫描框架，自带 poc，并发扫描 https://github.com/knownsec/Pocsuite 知道创宇维护的一个规范化 POC/EXP 利用框架 https://github.com/leisurelicht/Pocsuite3 Pocsuite 用 py3 重写 https://github.com/Eitenne/roxysploit 漏洞利用框架，支持永恒之蓝直接利用 https://github.com/TophantTechnology/osprey 斗象能力中心出品并长期维护的一个规范化 POC/EXP 利用框架 https://github.com/he1m4n6a/btScan 大黑阔的插件化漏洞利用工具 https://github.com/boy-hack/w9scan python 下内置 1200+插件可对网站进行一次规模的检测 https://github.com/WooYun/TangScan 乌云维护的一个规范化 POC/EXP 利用框架 https://github.com/n0tr00t/Beebeeto-framework Beebeeto 是由众多安全研究人员所共同维护的一个规范化 POC/EXP 利用框架 https://github.com/erevus-cn/pocscan 一款开源 Poc 调用框架,可轻松调用 Pocsuite,Tangscan,Beebeeto,Knowsec 老版本 POC，可使用 docker 部署 https://github.com/DavexPro/PocHunter 借鉴 pocscan 的一款多利用框架 poc 适配框架 https://github.com/theInfectedDrake/TIDoS-Framework 覆盖从侦察到漏洞分析的所有内容 https://github.com/gyoisamurai/GyoiThon 使用深度学习的渗透测试工具, 从每次扫描数据中学习, 扫描越多, 软件检测精准度越高 https://github.com/euphrat1ca/polar-scan 易语言的北极熊扫描器 https://github.com/euphrat1ca/yeezy-scan 椰树 1.9 扫描器 https://github.com/euphrat1ca/WebCruiserWVS 轻量级基于 C#的扫描器，椰树扫描器的前身 https://github.com/Skycrab/leakScan web 界面，漏洞扫描 https://github.com/az0ne/AZScanner web 界面，自动漏洞扫描器，子域名爆破，端口扫描，目录爆破，常用框架漏洞检测 https://github.com/boy-hack/w8scan web 界面，基于 bugscan 扫描和架构思想的扫描器 https://github.com/MiniSafe/microweb web 界面，base bugscan，django https://github.com/taipan-scanner/Taipan web 界面，基于 F#与 C#的安全扫描器 https://github.com/zhangzhenfeng/AnyScan web 界面，python 漏洞扫描器 https://github.com/Canbing007/wukong-agent web 界面，python 漏洞扫描器 https://github.com/dermotblair/webvulscan web 界面，php，漏洞扫描器，支持输出 pdf 报告 https://github.com/jeffzh3ng/InsectsAwake web 界面，基于 Flask 应用框架的漏洞扫描系统，同时集成了渗透测试常用的端口扫描、子域名爆破等功能，后端漏洞扫描采用 Pocsuite https://github.com/0xInfection/TIDoS-Framework py，linux，网站扫描器 https://github.com/secdec/adapt py,linux，网站扫描器 https://github.com/sullo/nikto perl，linux，kali 内置的网站扫描器 https://github.com/Ekultek/Zeus-Scanner web 扫描器，联动 Geckodriver，nmap 和 sqlmap https://github.com/blackye/lalascan 集合 owasp top10 漏洞扫描和边界资产发现能力的分布式 web 漏洞扫描框架 https://github.com/blackye/BkScanner BkScanner 分布式、插件化 web 漏洞扫描器 https://github.com/tlkh/prowler 一款基于 Raspberry Pi Cluster 的网络漏洞扫描工具 https://github.com/netxfly/passive_scan 基于 http 代理的 web 漏洞扫描器 https://github.com/1N3/Sn1per php，自动化中间件扫描以及设备指纹识别 https://github.com/Tuhinshubhra/RED_HAWK php，集成信息收集、漏洞扫描、指纹识别等的扫描工具 https://github.com/m4ll0k/Spaghetti web 应用扫描器，支持指纹识别、文件目录爆破、SQL/XSS/RFI 等漏洞扫描，也可直接用于 struts、ShellShock 等漏洞扫描 https://github.com/v3n0m-Scanner/V3n0M-Scanner 支持检测 SQLi/XSS/LFI/RFI 等漏洞的扫描器 https://github.com/Yukinoshita47/Yuki-Chan-The-Auto-Pentest 集成子域名枚举、nmap、waf 指纹识别等模块的 web 应用扫描器 https://github.com/RASSec/pentestEr_Fully-automatic-scanner 定向自动测试工具 https://github.com/Fireflyi/lcyscan py，插件化漏洞扫描器，支持生成报表 https://github.com/Arachni/arachni Web 应用漏洞扫描框架，支持 REST、RPC 等 api 调用 https://github.com/swisskyrepo/DamnWebScanner 基于 chrome/opera 插件的被动式漏洞扫描 https://github.com/0xsauby/yasuo ruby,扫描主机第三方 web 应用服务漏洞 https://github.com/yangbh/Hammer Web 应用漏洞扫描 https://github.com/viraintel/OWASP-Nettacker 自动化渗透测试框架 https://github.com/flipkart-incubator/watchdog 全面的 web 扫描器与漏洞利用工具 https://github.com/Fplyth0ner-Combie/Bug-Project-Framework 易语言，模仿 msf 的漏洞利用框架，自带 exp 编辑器 https://github.com/PowerScript/KatanaFramework py，模仿 msf 的漏洞利用框架，还有些 ssh、压缩包破解工具 https://github.com/m4ll0k/Galileo py2，网站扫描器 https://github.com/samhaxr/hackbox py2，simple，网站扫描器 https://github.com/secrary/EllaScanner py3，simple，被动式漏洞扫描，支持历史 cve 编号漏洞识别 https://github.com/m4ll0k/WAScan py，simple，扫描页面/链接/脚本/Form, 测试 Payload 等 https://github.com/jiangsir404/S7scan py,已用 1，七种综合检测 https://github.com/hatRiot/clusterd py，simple，web 漏洞利用 https://github.com/M4cs/BabySploit py,simple,模仿 msf https://github.com/iceyhexman/onlinetools simple，web 界面，在线 cms 指纹识别|旁站|c 段|信息泄露|工控|系统|物联网安全|cms 漏洞扫描|端口扫描|等 https://github.com/tulpar/tulpar simple,支持多种 web 漏洞扫描 https://github.com/UltimateHackers/Striker simple，信息搜集、cms 利用与漏扫，侦察绕过 Cloudflare https://github.com/0x4D31/salt-scanner 基于 Salt Open 以及 Vulners Linux Audit API 的 linux 漏洞扫描器，支持与 JIRA、slack 平台结合使用 https://github.com/opensec-cn/kunpeng go，POC 检测框架，以动态链接库的形式提供各种语言调用

运维安全服务与资产管理#

https://github.com/chaitin/cloudwalker CloudWalker（牧云）服务器安全管理平台，逐步覆盖服务器资产管理、威胁扫描、Webshell 查杀、基线检测等功能。 https://github.com/mitre/caldera mitre 公司模拟攻击测试系统，主要是在 win 下 https://github.com/guardicore/monkey 评估网络安全状况，分为扫描器与 C2C 服务器，利用默认口令与 exp 对 ssh、smb 等多种协议方式进行攻击检测 https://github.com/grayddq/PublicSecScan 调用 awvs 对大量 WEB 资产进行分布式 WEB 安全扫描，发现 web 环境下常规的一些安全漏洞 https://github.com/jeffzh3ng/Fuxi-Scanner 资产管理，漏洞检测集成 awvs、创宇 Pocsuite、nmap、hydra https://github.com/infobyte/faraday 协作渗透测试和漏洞管理平台，集成多种 https://github.com/DefectDojo/django-DefectDojo 基于 django 的漏洞资产管理平台 https://github.com/creditease-sec/insight web 界面，宜信安全部开发，集成应用系统资产管理、漏洞全生命周期管理、安全知识库管理三位一体的管理平台 https://github.com/RASSec/A_Scan_Framework 漏洞管理、资产管理、任务扫描系统 https://github.com/cea-sec/ivre 网络资产指纹发现，搭建属于自己的 shodan 与 zoomeye https://github.com/ysrc/xunfeng web 界面，同程安全开发的网络资产识别引擎，漏洞检测引擎 https://github.com/superhuahua/xunfengES web 界面，base 巡风开发，一个人的安全 https://github.com/zhaoweiho/SecurityManageFramwork py3，django。企业内网安全管理平台，包含资产管理，漏洞管理，账号管理，知识库管、安全扫描自动化功能模块 https://github.com/grayddq/PublicMonitors 对公网 IP 列表进行端口服务扫描，发现周期内的端口服务变化情况和弱口令安全风险。一个人的安全部 https://github.com/grayddq/PubilcAssetInfo 主要目标是以甲方安全人员的视角，尽可能收集发现企业的域名和服务器公网 IP 资产。如百度云、阿里云、腾讯云等。一个人的安全部 https://github.com/maya6/SiteScan web 界面，py3 celery。资产收集 https://github.com/ywolf/F-NAScan py2.6，网络资产、端口服务搜集整理，生成报表显示。快速 https://github.com/flipkart-incubator/RTA 扫描公司内部所有在线设备, 提供整体安全视图, 标示所有安全异常 https://github.com/0xbug/Biu-framework 企业内网基础服务安全扫描框架

上传漏洞利用#

https://github.com/UltimateHackers/Arjun 扫描网页, 使用正则表达式爆破查找隐藏的 GET/POST 参数 https://github.com/3xp10it/xupload 用于自动测试上传功能是否可上传 webshell 的工具 https://github.com/gunnerstahl/JQShell py3，CVE-2018-9206 jQuery File Upload 利用工具 https://github.com/destine21/ZIPFileRaider burp 插件，测试 zip 文件上传漏洞 https://github.com/jpiechowka/zip-shotgun py，测试 zip 文件上传漏洞

端口发现服务指纹识别#

https://github.com/nmap/nmap LUA,Nmap 端口扫描器，具有有强大的脚本引擎框架 https://github.com/robertdavidgraham/masscan C,无状态扫描，可以调用 nmap 进行指纹识别 https://github.com/zmap/zmap C,无状态扫描，需要用 C 编写扩展模块 https://github.com/zmap/zgrab go，基于 zmap 扫描器进行指纹识别、调度管理，可绕过 CDN https://github.com/chichou/grab.js 类似 zgrab 的快速 TCP 指纹抓取解析工具，支持更多协议 https://github.com/johnnyxmas/scancannon shell,联动 masscan 和 nmap https://github.com/OffensivePython/Nscan 基于 Masscan 和 Zmap 的网络扫描器 https://github.com/ring04h/wyportmap 调用 nmap 目标端口扫描+系统服务指纹识别 https://github.com/angryip/ipscan Angry IP Scanner，跨平台界面化端口扫描器 https://github.com/EnableSecurity/wafw00f WAF 产品指纹识别 https://github.com/rbsec/sslscan ssl 类型识别 https://github.com/urbanadventurer/whatweb web 指纹识别 https://github.com/Rvn0xsy/FastWhatWebSearch whatweb 工具结果搜索平台 https://github.com/tanjiti/FingerPrint web 应用指纹识别 https://github.com/nanshihui/Scan-T 网络爬虫式指纹识别 https://github.com/ywolf/F-MiddlewareScan 中间件扫描服务识别 https://github.com/lietdai/doom thorn 上实现的分布式任务分发的 ip 端口漏洞扫描器 https://github.com/RASSec/RASscan 端口服务扫描 https://github.com/m3liot/shcheck 用于检查 web 服务的 http header 的安全性 https://github.com/mozilla/ssh_scan 服务器 ssh 配置信息扫描 https://github.com/18F/domain-scan 针对域名及其子域名的资产数据检测／扫描，包括 http/https 检测等 https://github.com/ggusoft/inforfinder 域名资产收集及指纹识别工具 https://github.com/0xbug/Howl 网络设备 web 服务指纹扫描与检索 https://github.com/mozilla/cipherscan 目标主机服务 ssl 类型识别 https://github.com/medbenali/CyberScan 渗透测试辅助工具，支持分析数据包、解码、端口扫描、IP 地址分析等 https://github.com/jekyc/wig web 应用信息搜集工具 https://github.com/eldraco/domain_analyzer 围绕 web 服务的域名进行信息收集和”域传送”等漏洞扫描，也支持针对背后的服务器端口扫描等 https://github.com/cloudtracer/paskto 基于 Nikto 扫描规则的被动式路径扫描以及信息爬虫 https://github.com/zerokeeper/WebEye 快速识别 WEB 服务器类型、CMS 类型、WAF 类型、WHOIS 信息、以及语言框架 https://github.com/n4xh4ck5/CMSsc4n CMS 指纹识别 https://github.com/HA71/WhatCMS CMS 检测和漏洞利用脚本, 基于 Whatcms.org API https://github.com/boy-hack/gwhatweb CMS 识别 python gevent 实现 https://github.com/wpscanteam/wpscan 基本算是 word press 下最好用的工具了 https://github.com/swisskyrepo/Wordpresscan 基于 WPScan 以及 WPSeku 的优化版 wordpress 扫描器 https://github.com/m4ll0k/WPSeku 精简的 wordpress 扫描工具 https://github.com/rastating/wordpress-exploit-framework wordpress 漏洞利用框架 https://github.com/Jamalc0m/wphunter php，wordpress 扫描器 https://github.com/UltimateLabs/Zoom wordpress 漏洞扫描器 https://github.com/immunIT/drupwn Drupal 信息收集与漏洞利用工具 https://github.com/CHYbeta/cmsPoc CMS 渗透测试框架 https://github.com/chuhades/CMS-Exploit-Framework CMS 攻击框架 https://github.com/Tuhinshubhra/CMSeeK 20 多种 CMS 的基本检测，针对 wp 利用、可定制模块化爆破功能 https://github.com/Dionach/CMSmap 支持 WordPress，Joomla 和 Drupal 扫描 https://github.com/Moham3dRiahi/XAttacker Web CMS Exploit 工具,包含针对主流 CMS 的 66 个不同的 Exploits https://github.com/code-scan/dzscan 首款集成化的 Discuz 扫描工具

数据库扫描与爆破#

https://github.com/ron190/jsql-injection Java 编写的 SQL 注入工具 https://github.com/shack2/SuperSQLInjectionV1 安恒航牛的一款界面化注入工具 https://github.com/sqlmapproject/sqlmap sql 注入 sqlmap https://github.com/stamparm/DSSS 已用 1,99 行代码实现的 sql 注入漏洞扫描器 https://github.com/Hadesy2k/sqliv 已用 1,基于搜索引擎的批量 SQL 注入漏洞扫描器 https://github.com/quentinhardy/odat 一款专门用于 Oracle 渗透的很全面的工具 https://github.com/m8r0wn/enumdb MySQL 和 MSSQL 利用工具后期爆破、搜索数据库并提取敏感信息。 https://github.com/LoRexxar/Feigong 针对各种情况自由变化的 MySQL 注入脚本 https://github.com/youngyangyang04/NoSQLAttack 一款针对 mongoDB 的攻击工具 https://github.com/Neohapsis/bbqsql SQL 盲注利用框架 https://github.com/NetSPI/PowerUpSQL 基于 Powershell 的 sqlserver 测试框架 http://www.4hou.com/system/14950.html 利用 PowerUpSQL，渗透测试技巧：绕过 SQL Server 登录触发器限制 https://github.com/WhitewidowScanner/whitewidow 一款数据库扫描器 https://github.com/stampery/mongoaudit MongoDB 审计及渗透工具 https://github.com/torque59/Nosql-Exploitation-Framework NoSQL 扫描/爆破工具 https://github.com/missDronio/blindy MySQL 盲注爆破工具 https://github.com/JohnTroony/Blisqy 用于 http header 中的时间盲注爆破工具，仅针对 MySQL/MariaDB https://github.com/se55i0n/DBScanner 自动扫描内网中常见 sql、no-sql 数据库脚本，包含未授权访问及常规弱口令检测 https://github.com/Turr0n/firebase 对没有正确配置的 firebase 数据库进行利用

XSS 跨站脚本检测利用#

https://github.com/UltimateHackers/AwesomeXSS XSS Awesome 系列 http://www.xss-payloads.com 很全面的 xss 工具包与资料 https://github.com/ismailtasdelen/xss-payload-list XSS 漏洞 Payload 列表 https://github.com/beefproject/beef 经典的 xss 利用框架 https://github.com/samdenty99/injectify 类似 beef 的 xss 利用框架 https://github.com/firesunCN/BlueLotus_XSSReceiver 蓝莲花战队为 CTF 打造的 xss 利用框架 https://github.com/NytroRST/XSSFuzzer 根据特定标签生成 xss payload https://github.com/evilcos/xssor2 余弦写的 xss 利用辅助工具 https://github.com/UltimateHackers/XSStrike 可识别并绕过 WAF 的 XSS 扫描工具 https://github.com/raz-varren/xsshell go,利用 xss 漏洞返回一个 js 交互 shell https://github.com/UltimateHackers/JShell 利用 xss 漏洞返回一个 js 交互 shell https://github.com/shawarkhanethicalhacker/BruteXSS 一款 XSS 扫描器,可暴力注入参数 https://github.com/1N3/XSSTracer 小型 XSS 扫描器,也可检测 CRLF、XSS、点击劫持的 https://github.com/0x584A/fuzzXssPHP PHP 版本的反射型 xss 扫描 https://github.com/chuhades/xss_scan 批量扫描 XSS 的 python 脚本 https://github.com/BlackHole1/autoFindXssAndCsrf 自动化检测页面是否存在 XSS 和 CSRF 漏洞的浏览器插件 https://github.com/shogunlab/shuriken 使用命令行进行 XSS 批量检测 https://github.com/stamparm/DSXS 支持 GET、POST 方式的高效 XSS 扫描器 https://github.com/bsmali4/xssfork kali 下无法使用的话，请下载正确的 PhantomJS 到目录 thirdparty/phantomjs/Linux https://github.com/riusksk/FlashScanner flash xss 扫描 https://github.com/Damian89/xssfinder 针对检测网站中的反射 XSS https://github.com/BlackHole1/WebRtcXSS 自动化利用 XSS 入侵内网

弱口令扫描爆破#

https://github.com/vanhauser-thc/thc-hydra 支持多种协议方式的破解与爆破，v8 以后就不提供 windows 版本了 https://github.com/nmap/ncrack c，支持多种协议的破解与爆破 https://github.com/0pn1i9ht/F-Scrack ysrc 对各类服务用户名密码爆破的脚本 https://github.com/TunisianEagles/SocialBox 针对 fb、gmail、ins、twitter 的用户名密码爆破的脚本 https://github.com/lanjelot/patator 支持多种协议的爆破，采用模块化设计，使用灵活 https://github.com/m4ll0k/SMBrute 利用 smb 服务进行用户名密码爆破 https://github.com/netxfly/crack_ssh Go 写的协程版的 ssh\redis\mongodb 弱口令破解 https://github.com/UltimateHackers/Blazy 支持测试 CSRF, Clickjacking, Cloudflare and WAF 的弱口令探测器 https://github.com/Moham3dRiahi/XBruteForcer WordPress、Joomla、DruPal、OpenCart、Magento 等 CMS 用户密码爆破 https://github.com/shengqi158/weak_password_detect Linux 下利用 nmap 多线程探测 ssh 弱口令 https://github.com/ztgrace/changeme 弱口令扫描器，不仅支持普通登录页，也支持 ssh、mongodb 等组件 https://github.com/lijiejie/htpwdScan simple，http 暴力破解、撞库攻击脚本 https://github.com/scu-igroup/ssh-scanner 联动 nmap、hydra 对 ssh 批量爆破

密码破解还原#

https://securityxploded.com/download.php 各种密码方向安全小工具 https://github.com/bdutro/ibm_pw_clear IBM x3550/x3560 M3 bios 密码清除重置工具 https://github.com/thehappydinoa/iOSRestrictionBruteForce py,实现的 ios 访问限制密码破解工具 https://github.com/hashcat/hashcat C,哈希破解 https://github.com/fireeye/gocrack GO,基于 hashcat 3.6.0+的分布式密码破解工具 https://github.com/s3inlc/hashtopolis 基于 php 的 hashcat 的分布式破解工具，支持 C#与 python 客户端 https://github.com/e-ago/bitcracker 首款开源的 BitLocker 密码破解工具 https://www.ru.nl/publish/pages/909282/draft-paper.pdf 破解 SSD 下使用 BitLocker 的论文 https://github.com/magnumripper/JohnTheRipper 已知密文的情况下尝试破解出明文的破解密码软件 https://github.com/shinnok/johnny JohnTheRipper 密码破解的 GUI 界面，理论兼容所有功能，有 windows 界面 https://github.com/jmk-foofus/medusa 支持的协议会比 hydra 少一点，但是某些速度会快 https://github.com/MrSqar-Ye/wpCrack wordpress hash 破解 https://github.com/testsecer/Md5Decrypt C#,基于网上 web API 的 MD5 搜索工具 https://github.com/s0md3v/Hash-Buster 能调用多个 API 进行 hash 破解查询的智能工具 https://www.52pojie.cn/thread-275945-1-1.html ARCHPR Pro4.54 绿色中文破解版。压缩包密码破解，利用“已知明文攻击”破解加密的压缩文件

网站管理与 Webshell#

http://www.bt.cn 宝塔网站管理系统 https://github.com/AntSwordProject/antSword js,中国蚁剑,插件式开发 https://github.com/Chora10/Cknife java，中国菜刀 https://github.com/naozibuhao/SecQuanCknife java，中国菜刀升级版，增加爆破功能 https://github.com/euphrat1ca/hatchet 中国大砍刀 https://github.com/tengzhangchao/PyCmd py，一句话木马客户端程序，目前支持 php、jsp，CS 端通信加密 https://github.com/epinna/weevely3 py,利用特定的一句话脚本对网站进行管理 https://github.com/nil0x42/phpsploit py3,利用特定的一句话脚本对网站进行管理 https://github.com/wonderqs/Blade py，利用特定的一句话脚本对网站进行管理 https://github.com/anestisb/WeBaCoo perl，利用特定的一句话脚本对网站进行管理 https://github.com/keepwn/Altman .net 配合 mono，实现的跨平台菜刀 https://github.com/k4mpr3t/b4tm4n 集成伪造邮件 ddos，bat.php 的 webshell，初始 k4mpr3t https://github.com/dotcppfile/DAws 过防火墙 webshell，post pass=DAws https://github.com/b374k/b374k php 网站管理，默认密码 b374k https://github.com/wso-shell/WSO webshell 的文件管理，可以伪装为 404 界面 https://github.com/UltimateHackers/nano php 小马，附带 py 编写的生成器 https://github.com/rebeyond/memShell 一款可以写入 java web server 内存中的 webshell https://github.com/DXkite/freebuf-stream-shell PHP 使用流包装器实现 WebShell。freebuf 上有详细文章 https://xz.aliyun.com/t/2799 利用动态二进制加密实现新型一句话木马之客户端篇 https://github.com/rebeyond/Behinder “冰蝎”动态二进制加密网站管理客户端 https://xz.aliyun.com/t/2744#toc-8 利用动态二进制加密实现新型一句话木马之 Java 篇 https://xz.aliyun.com/t/2758#toc-4 利用动态二进制加密实现新型一句话木马之.NET 篇 https://xz.aliyun.com/t/2774#toc-4 利用动态二进制加密实现新型一句话木马之 PHP 篇

内网拓展后渗透#

https://github.com/OpenWireSec/metasploit 后渗透框架 https://github.com/EmpireProject/Empire 基于 poweshell 的命令执行框架 https://github.com/TheSecondSun/Bashark 纯 Bash 脚本编写的后渗透框架，大鲨鱼 https://github.com/JusticeRage/FFM py3，拥有下载、上传功能，生成可执行 py 脚本的后门的后渗透框架 https://github.com/DarkSpiritz/DarkSpiritz py2,后渗透框架 https://github.com/byt3bl33d3r/CrackMapExec 网络测试中的瑞士军刀，包含 impacket、PowerSploit 等多种模块 https://github.com/SpiderLabs/scavenger 对 CrackMapExec 进行二次包装开发进行内网敏感信息扫描 https://github.com/jmortega/python-pentesting python-pentesting-tool python 安全工具相关功能模块 https://github.com/0xdea/tactical-exploitation Python/PowerShell 的测试脚本集 https://github.com/PowerShellMafia/PowerSploit powershell 测试脚本集与开发框架汇总 https://github.com/samratashok/nishang powershell 脚本集与利用框架 https://github.com/PowerShellEmpire/PowerTools PowerShell 脚本集，停止更新 https://github.com/FuzzySecurity/PowerShell-Suite PowerShell 脚本集 https://github.com/rvrsh3ll/Misc-Powershell-Scripts PowerShell 脚本集 https://github.com/nccgroup/redsnarf 窃取哈希，密码解密，偷偷调用猕猴桃等程序，rdp 多方法利用，远程启动 shell，清楚痕迹 https://github.com/BloodHoundAD/BloodHound 用于分析域成员和用用户关系的程序，通过用 powershell 脚本导出域内的 session、computer、group、user 等信息，入库后进行可视化分析可以做到定点攻击。 https://github.com/xorrior/RemoteRecon 利用 DotNetToJScript 进行截图、key 记录、token 窃取、dll 与恶意代码注入 https://github.com/SkyLined/LocalNetworkScanner 利用浏览器漏洞当对方打开网址时，扫描对方内网信息 https://github.com/fdiskyou/hunter 调用 Windows API 对内网信息进行搜集很全面 https://github.com/0xwindows/VulScritp 内网渗透脚本，包括 banner 扫描、端口扫描；phpmyadmin、jenkins 等通用漏洞利用等 https://github.com/lcatro/network_backdoor_scanner 基于网络流量的内网探测框架 https://github.com/sowish/LNScan 详细的内部网络信息扫描器 https://github.com/rootlabs/nWatch 联动 nmap，并对组织内网进行扫描 https://github.com/m8r0wn/nullinux 用于 Linux 的内部渗透测试工具，可用于通过 SMB 枚举操作系统信息，域信息，共享，目录和用户。 https://github.com/zMarch/Orc bash，Linux 下后渗透命令集合

远程控制 C2 服务器#

https://github.com/malwaredllc/byob 僵尸网络生成框架 https://github.com/proxycannon/proxycannon-ng 构建攻击僵尸网络 https://github.com/deadPix3l/CryptSky/ 勒索软件 poc https://github.com/jgamblin/Mirai-Source-Code 蠕虫病毒 poc https://github.com/AhMyth/AhMyth-Android-RAT 基于 smali，Windows 下安卓远控，一对多带界面 https://github.com/ssooking/cobaltstrike3.12_cracked java1.8，远控、钓鱼、内网 https://github.com/Mr-Un1k0d3r/ThunderShell py2，CLI 与 web 端，内存马，RC4 加密 HTTP 传输 https://github.com/tiagorlampert/CHAOS go，win 远控，可过大部分杀软 https://github.com/Ne0nd0g/merlin go，c2 通讯，一对多 https://github.com/0x09AL/Browser-C2 go，利用 chrome 以浏览器的形式连接 C2 服务器 https://github.com/xdnice/PCShare c++，可以监视目标机器屏幕、注册表、文件系统等 https://github.com/quasar/QuasarRAT c#，一对多，界面 https://github.com/TheM4hd1/Vayne-RaT c#，一对多，界面 https://github.com/nettitude/PoshC2 PowerShell、C#，远控工具，有 win 提权组件 https://github.com/euphrat1ca/njRAT-v0.7d vb，常见蠕虫远控，有很多变种，一对多带界面 https://github.com/zerosum0x0/koadic py3,利用 JScript/VBScript 进行控制，大宝剑 https://github.com/Ridter/MyJSRat py2，利用 js 后门，配合 chm、hta 可实现很多后门方式。evi1cg.me/archives/chm_backdoor.html https://github.com/its-a-feature/Apfell py3，macOS 与 linux 下的利用 js 后门，web 界面管理 https://github.com/peterpt/fuzzbunch py2，NSA 漏洞利用工具，配有自动化安装脚本与 gui 界面，远控 rat https://github.com/n1nj4sec/pupy py，Windows, Linux, OSX, Android 跨平台，一对多 https://github.com/nathanlopez/Stitch py，Windows、Mac OSX、Linux 跨平台 https://github.com/neoneggplant/EggShell py，macos/osx 远控,可生成 HID 代码，一对多 https://github.com/Marten4n6/EvilOSX py，macos/osx 远控，一对多 https://github.com/vesche/basicRAT py3，simple 远控，一对多 https://github.com/Viralmaniar/Powershell-RAT py，截图通过 gmail 传输 https://github.com/byt3bl33d3r/gcat py，使用 gmail 作为 C&C 服务器 https://github.com/sweetsoftware/Ares py，c2 通讯，支持代理 https://github.com/micle-fm/Parat py，利用 telegram，windows 下的远程控制工具 https://github.com/ahhh/Reverse_DNS_Shell py，通过 dns 传输 https://github.com/iagox86/dnscat2 服务端为 ruby（linux），客户端为 C（win/linux），利用 DNS 协议进行端对端传输 https://github.com/deepzec/Grok-backdoor py，利用 ngrok 的后门 https://github.com/trustedsec/trevorc2 py，搭建一个合法的网站（可浏览），用于隐藏命令执行的客户端/服务器通信

端口转发与代理工具#

https://github.com/fatedier/frp 用于内网穿透的高性能的反向代理应用，支持 tcp, udp, http, https 协议 https://github.com/inconshreveable/ngrok 端口转发，正反向代理，内网穿透 http://ngrok.ciqiuwl.cn/ 在线小米球 ngrok https://github.com/knownsec/rtcp Socket 端口转发，用于远程维护 https://github.com/davrodpin/mole 基于 ssh 的端口转发 http://rootkiter.com/EarthWorm 一款用于开启 SOCKS v5 代理服务的工具，基于标准 C 开发，可提供多平台间的转接通讯，用于复杂网络环境下的数据转发。 http://rootkiter.com/Termite/README.txt EarthWorm 升级版，可以实现多节点跳跃 https://github.com/SECFORCE/Tunna 可以通过 HTTP 封装隧道通信任何 TCP，以及用于绕过防火墙环境中的网络限制 https://github.com/fbkcs/thunderdns 将 tcp 流量通过 DNS 协议转发，不需要客户端和 socket5 支持 https://github.com/sensepost/reGeorg reDuh 的升级版，主要是把内网服务器的端口通过 http/https 隧道转发到本机，形成一个回路。用于目标服务器在内网或做了端口策略的情况下连接目标服务器内部开放端口（提供了 php，asp，jsp 脚本的正反向代理） https://github.com/SpiderClub/haipproxy py3,Scrapy and Redis,高可用 ip 代理池 https://github.com/chenjiandongx/async-proxy-pool py3 异步爬虫 ip 代理池 https://github.com/audibleblink/doxycannon 使用一个 openvpn 代理池，为每一个生成 docker，当连接某一个 vpn 后，其它的进行 socks5 转发做流量分发 https://github.com/decoder-it/psportfwd PowerShell 编写的端口转发工具, 无需 admin 权限 https://github.com/ls0f/gortcp go，通过主控端、中转、被控端实现内网穿透

Cross 超越边界 NPV#

https://github.com/bannedbook/fanqiang/wiki cross 汇总 https://github.com/teddysun/across 梯子搭建 https://github.com/ToyoDAdoubi/doubi 各种常用一键脚本 https://github.com/Nyr/openvpn-install openvpn 一键 https://github.com/quericy/one-key-ikev2-vpn CentOS/Debian/Ubuntu 一键安装 IPSEC/IKEV2 VPN 脚本 https://github.com/teddysun/shadowsocks_install shadowsocks,shadowsocksr https://github.com/guyingbo/shadowproxy ss/socks5/http//https 等多种代理 https://github.com/shadowsocks/shadowsocks-manager shadowsocks 多用户管理 https://github.com/leitbogioro/SSR.Go shadowsocksrr 配置管理简化工具 https://github.com/ssrpanel/SSRPanel ss\ssr\v2ray 用户分布式管理 https://github.com/xuanhuan/ss-panel ss 用户分布式管理 https://github.com/Ahref-Group/SS-Panel-smarty-Edition ss 用户分布式管理，兑换码功能、商城系统，服务器信息 https://github.com/Ccapton/brook-web brook 程序服务端 Web 后台管理服务器（Linux|MacOS），基于 python、flask、flask-restful https://github.com/Ccapton/brook-ok Brook 一键安装脚本 https://github.com/txthinking/brook go，支持 Linux/MacOS/Windows/Android/iOS 的代理与 vpn https://github.com/gwuhaolin/lightsocks 轻量级网络混淆代理，基于 SOCKS5 协议，类 SS https://github.com/Umbrellazc/BypassCampusNet 校园网防断网; UDP 53 免流上网 https://doub.io/dbrj-5/ 通过虚拟网卡转为类 VPN 全局代理 SSTAP，还有 sockscap64，比 proxifier 使用简单 https://github.com/ntkernel/lantern unlimited-landeng-for-win，无限流量蓝灯 https://www.psiphon3.com 开源赛风超越边界代理 https://hide.me 可试用 https://windscribe.com 可试用 http://www.vpngate.net 日本国立筑波大学超越边界代理 https://rava.app 注册可免费用一天

横向移动与密码 Hash 窃取#

http://www.oxid.it/cain.html Cain & Abel 支持密码还原、arp 中间人攻击 https://github.com/gentilkiwi/mimikatz Windows 下以抓取密码为主的横向移动神器 https://github.com/skelsec/pypykatz 使用纯 py3 实现的 mimikatz https://github.com/eladshamir/Internal-Monologue 无需 LSASS 进程使用 Mimikatz 从 LSASS 进程内存中提取内容, 从内存中提取明文密码, NTLM 哈希, Kerberos ticket, 以及执行 pass-the-hash/pass-the-ticket 攻击等 https://github.com/AlessandroZ/LaZagne py3，密码抓取工具 https://github.com/AlessandroZ/LaZagneForensic LaZagne 密码破解升级版，利用 DPAPI，目前缺陷是需要 windows user 密码 https://github.com/twelvesec/passcat Windows 下密码抓取工具 https://github.com/huntergregal/mimipenguin linux 密码抓取神器 https://github.com/quarkslab/quarkspwdump quarkslab 出品的密码抓取工具，不用注入任何进程 https://github.com/mthbernardes/sshLooter 从 ssh 服务中窃取用户名密码 https://github.com/nettitude/Invoke-PowerThIEf 利用 IE 进行后渗透，抓取密码、重定向等 https://github.com/GhostPack/Rubeus 操作 Kerberos 的库, 实现了 Kekeo 的大部分功能, C#编写 https://github.com/m8r0wn/ldap_search PY,通过 ldap（轻量目录访问协议）认证，列举 win 域信息，爆破登录

Linux 提权相关#

https://github.com/AlessandroZ/BeRoot py,通过检查常见的错误配置来查找提权方法. 支持 Windows/Linux/Mac https://github.com/mschwager/0wned 利用 python 包进行高权限用户创建 https://github.com/mzet-/linux-exploit-suggester 查找 linux 有哪些补丁没有打的脚本 https://github.com/belane/linux-soft-exploit-suggester 查找 linux 有哪些有漏洞的软件 https://github.com/dirtycow/dirtycow.github.io 脏牛提权漏洞 exp https://github.com/FireFart/dirtycow 脏牛提权漏洞 exp https://github.com/stanleyb0y/sushell 利用 su 小偷实现低权限用户窃取 root 用户口令 https://github.com/jas502n/CVE-2018-17182/ Linux 内核 VMA-UAF 提权漏洞 CVE-2018-17182 https://github.com/jas502n/CVE-2018-14665 CVE-2018-14665，linux 下 Xorg X 服务器提权利用 https://github.com/nmulasmajic/syscall_exploit_CVE-2018-8897 Linux 系统利用 Syscall 实现提权 https://github.com/can1357/CVE-2018-8897 Linux 系统利用 Syscall 实现提权 https://github.com/SecWiki/linux-kernel-exploits linux-kernel-exploits Linux 平台提权漏洞集合 https://github.com/nilotpalbiswas/Auto-Root-Exploit linux 自动提权脚本 https://github.com/WazeHell/PE-Linux Linux 提权工具 https://guif.re/linuxeop linux 提权命令集合

Windows 提权相关#

http://www.fuzzysecurity.com/tutorials/16.html windows 平台教程级提权参考文章 https://github.com/SecWiki/windows-kernel-exploits Windows 平台提权漏洞 Exp 集合 https://github.com/51x/WHP windows 下各种提权与利用工具 https://github.com/rasta-mouse/Sherlock win 提权漏洞验证 https://github.com/WindowsExploits/Exploits 微软 CVE-2012-0217、CVE-2016-3309、CVE-2016-3371、CVE-2016-7255、CVE-2017-0213 提权利用 https://github.com/decoder-it/lonelypotato RottenPotatoNG 变种，利用 NBNS 本地域名欺骗和 WPAD 代理欺骗提权 https://github.com/ohpe/juicy-potato RottenPotatoNG 变种，利用 com 对象、用户 token 进行提权 https://github.com/foxglovesec/Potato RottenPotatoNG 变种，利用本地域名欺骗和代理欺骗提权 https://github.com/DanMcInerney/icebreaker 处于内网环境但又在 AD 环境之外，icebreaker 将会帮助你获取明文 Active Directory 凭据（活动目录存储在域控服务器可用于提权） https://github.com/hausec/ADAPE-Script Active Directory 权限提升脚本 https://github.com/klionsec/BypassAV-AllThings 利用 aspx 一句话配合提权 payload 提权 https://github.com/St0rn/Windows-10-Exploit msf 插件，win10 uac bypass https://github.com/sam-b/CVE-2014-4113 利用 Win32k.sys 内核漏洞进行提取，ms14-058 https://github.com/breenmachine/RottenPotatoNG 利用 NBNS 本地域名欺骗和 WPAD 代理欺骗提权 https://github.com/unamer/CVE-2018-8120 影响 Win32k 组件，针对 win7 和 win2008 提权 https://github.com/alpha1ab/CVE-2018-8120 在 win7 与 win2k8 的基础上增加了 winXP 与 win2k3 https://github.com/0xbadjuju/Tokenvator 使用 Windows 令牌提升权限的工具，提供一个交互命令行界面

权限绕过#

https://payloads.online/archivers/2018-12-22/1 DLL Hijacking & COM Hijacking ByPass UAC – 议题解读 https://github.com/tyranid/DotNetToJScript 能够利用 JS/Vbs 脚本加载.Net 程序的工具 https://github.com/mdsecactivebreach/SharpPack 绕过系统应用白名单执行 DotNet and PowerShell tools https://github.com/rootm0s/WinPwnage py2，win 下权限提升，uac 绕过，dll 注入等 https://github.com/hfiref0x/UACME 包含许多用于多个版本操作系统上绕过 Windows 用户帐户控制的方法 https://github.com/Ben0xA/nps 实现了不使用 powershell.exe 的情况下执行 powershell 命令 https://github.com/Mr-Un1k0d3r/PowerLessShell 实现了不调用 powershell.exe 的情况下执行 powershell 命令 https://github.com/p3nt4/PowerShdll 使用 rundll32 运行 PowerShell，绕过软件限制 https://github.com/ionescu007/r0ak 内核层的瑞士军刀. 在 Windows10 内核中读/写/执行代码 https://github.com/leechristensen/UnmanagedPowerShell 从一个非托管程序来执行 PowerShell,经过一些修改后可以被用来注入到其他进程 https://github.com/stephenfewer/ReflectiveDLLInjection 一种库注入技术，让 DLL 自身不使用 LoadLibraryA 函数,将自身映射到目标进程内存中 https://github.com/ChrisAD/ads-payload 利用环境变量与 destop.ini 绕过 windows 下的 Palo Alto Traps endpoint 防护软件 https://github.com/Zer0Mem0ry/RunPE 通过内存读取，网络传输内容，利用 PE 执行 shellcode

沙盒逃逸#

https://github.com/hacksysteam/WpadEscape 利用 wpad 进行浏览器 sandbox 沙箱逃逸 https://github.com/unamer/vmware_escape vmware 虚拟机逃逸。CVE-2017-4901，CVE-2018-6981，CVE-2018-6982 https://github.com/MorteNoir1/virtualbox_e1000_0day VirtualBox E1000 Guest-to-Host Escape 逃逸。教程 https://bugs.chromium.org/p/project-zero/issues/detail?id=1682&desc=2 Ghostscript：基于漏洞 CVE-2018-17961 的-dSAFER 沙盒逃逸技术

后门免杀代码混淆#

https://www.shellterproject.com 杀毒软件绕过 https://github.com/trustedsec/unicorn py，一键生成多种后门 https://github.com/islamTaha12/Python-Rootkit windows 下 rootkit，反弹 meterpreter https://github.com/n00py/Hwacha linux 下快速生成 metepreter 等多种 payload https://github.com/Screetsec/Vegile msf 免杀，程序注入 https://github.com/MohamedNourTN/Terminator py2，msf 免杀 https://github.com/Veil-Framework/Veil msf 免杀 https://github.com/abedalqaderswedan1/aswcrypter py、bash，msf 免杀 https://github.com/Screetsec/TheFatRat java，msf 免杀，利用 searchsploit 快速搜索 https://github.com/pasahitz/zirikatu msf 免杀 https://github.com/govolution/avet msf 免杀 https://github.com/GreatSCT/GreatSCT msf 免杀 https://github.com/EgeBalci/HERCULES msf 免杀 https://github.com/trustedsec/nps_payload msf 免杀 https://github.com/4w4k3/Insanity-Framework py，payload 生成，过杀软，识别虚拟机，钓鱼，内存注入等 https://github.com/hlldz/SpookFlare Meterpreter，Empire，Koadic 等 loader/dropper 的生成器，可以绕过客户端检测和网络端检测的端点策略 https://github.com/pasahitz/regsvr32 使用 C#+Empire 实现最小体积免杀后门 https://github.com/malcomvetter/UnstoppableService 将自身安装为 Windows 服务且管理员无法停止/暂停服务的程序. C#编写 https://github.com/Cn33liz/StarFighters 基于 DotNetToJScript，利用 JavaScript 和 VBScript 执行 Empire Launcher https://github.com/mdsecactivebreach/SharpShooter 基于 DotNetToJScript 使用 js、vbs，用于检索和执行任意 CSharp 源码的 payload 创建框架 https://github.com/mdsecactivebreach/CACTUSTORCH 基于 DotNetToJScript 使用 js、vbs 生成恶意 payload https://github.com/OmerYa/Invisi-Shell 对 powershell 文件进行混淆 https://github.com/danielbohannon/Invoke-DOSfuscation 对 powershell 文件进行混淆，加密操作以及重新编码 https://github.com/danielbohannon/Invoke-Obfuscation 对 powershell 文件进行混淆，加密操作以及重新编码 https://github.com/Mr-Un1k0d3r/SCT-obfuscator Cobalt Strike SCT 有效载荷混淆器 https://github.com/tokyoneon/Armor bash，生成加密 Payload 在 macOS 上反弹 Shell https://github.com/Mr-Un1k0d3r/MaliciousMacroGenerator 宏混淆，其中还包括 AV/Sandboxes 逃避机制 https://github.com/Kkevsterrr/backdoorme py3、py2 多种类型的后门、shell 生成工具，可以自动维持权限 https://github.com/TestingPens/MalwarePersistenceScripts win 下权限维持脚本 https://github.com/mhaskar/Linux-Root-Kit py，simple，linux 下 rootkit https://github.com/PinkP4nther/Sutekh simple，rootkit，使普通用户获取 root shell https://github.com/threatexpress/metatwin 从一个文件中提取元数据，包括数字签名，并注入到另一个文件中 https://github.com/Mr-Un1k0d3r/Windows-SignedBinary 可以修改二进制文件的 HASH，同时保留微软 windows 的签名 https://github.com/secretsquirrel/SigThief py，用于劫持合法的数字签名并绕过 Windows 的哈希验证机制的脚本工具 https://github.com/9aylas/Shortcut-Payload-Generator 快捷方式(.lnk)文件 Payload 生成器.AutoIt 编写 https://github.com/GuestGuri/Rootkit 反弹一个 tcp 连接，将进程 id 绑定到一个空文件夹 https://github.com/secretsquirrel/the-backdoor-factory 可以生成 win32PE 后门测试程序,ELF 文件后门程序等

社工相关#

https://github.com/brannondorsey/PassGAN py,深度学习,密码字典样本生成 https://github.com/Mebus/cupp 根据用户习惯密码生成弱口令探测 https://github.com/Saferman/cupper 根据用户习惯密码生成弱口令探测，楼上升级 https://github.com/LandGrey/pydictor py3，特定密码字典生成 https://github.com/mehulj94/Radium-Keylogger python 下的键盘记录工具 https://github.com/threatexpress/domainhunter 检查过期域名，bluecoat 分类和 Archive.org 历史记录，以确定最为适合于钓鱼和 C2 的域名 https://github.com/Mr-Un1k0d3r/CatMyPhish 收集目标类似的尚未注册的域名 https://github.com/x0day/Multisearch-v2 Bing、google、360、zoomeye 等搜索引擎聚合搜索，可用于发现企业被搜索引擎收录的敏感资产信息 https://github.com/n0tr00t/Sreg Sreg 可对使用者通过输入 email、phone、username 的返回用户注册的所有互联网护照信息。 https://github.com/SpiderLabs/social_mapper 社交媒体枚举和关联工具, 通过人脸识别关联人物侧写 https://github.com/vysec/MaiInt 公司雇员信息收集测试工具 https://github.com/jofpin/trape py，利用 OSINT 对人员进行追踪定位 https://github.com/famavott/osint-scraper 输入人名或邮箱地址, 自动从互联网爬取关于此人的信息 https://github.com/xHak9x/fbi py2,facebook 脸书信息搜集工具 https://github.com/initstring/linkedin2username 通过 Linkedin 领英获取相关公司员工列表 https://github.com/0x09AL/raven linux 下领英 Linkedin information gathering tool https://github.com/Ridter/Mailget 通过脉脉用户猜测企业邮箱 https://github.com/haccer/tweep 使用 twitter API 进行信息爬取查询 https://github.com/MazenElzanaty/TwLocation py，获取 Twitter 用户发推的地址 https://github.com/vaguileradiaz/tinfoleak web 界面，对某人的 twitter 进行全面的情报分析 https://github.com/deepfakes 虚假音视频制作 https://www.jianshu.com/p/147cf5414851 聊聊那些常见的探侦类 APP https://github.com/thinkst/canarytokens 重要文件的追踪溯源，信标定位（https://canarytokens.org/generate#） https://github.com/ggerganov/kbd-audio c++,linux,利用麦克风监控键盘输入测试输入值

钓鱼框架邮件伪造#

https://github.com/bhdresh/SocialEngineeringPayloads 负责收集用于证书盗窃和鱼叉式网络钓鱼攻击的社交工程技巧和 payloads https://github.com/trustedsec/social-engineer-toolkit 专为社交工程设计的开源渗透测试框架 https://github.com/thelinuxchoice/blackeye 拥有 facebook、instagram 等三十余个钓鱼模板的一键启用工具 https://github.com/M4cs/BlackEye-Python 以 blackeye 为基础加强子域的管理 https://github.com/azizaltuntas/Camelishing py3，界面化社会工程学攻击辅助工具 https://github.com/JonCooperWorks/judas go，克隆网站钓鱼 https://github.com/gophish/gophish go，拥有在线模板设计、发送诱骗广告等功能的钓鱼系统 https://github.com/tatanus/SPF py2，deefcon 上的钓鱼系统 https://github.com/MSG-maniac/mail_fishing 甲方内部钓鱼系统 https://github.com/samyoyo/weeman 钓鱼的 http 服务器 https://github.com/Raikia/FiercePhish 可以管理所有钓鱼攻击的完整钓鱼框架，允许你跟踪单独的网络钓鱼活动，定时发送电子邮件等 https://github.com/securestate/king-phisher 可视化钓鱼活动工具包 https://github.com/fireeye/ReelPhish 实时双因素网络钓鱼工具 https://github.com/kgretzky/evilginx 绕过双因素验证的钓鱼框架 https://github.com/kgretzky/evilginx2 MiTM 框架, 登录页面钓鱼, 绕过双因素认证等 https://github.com/ustayready/CredSniper 使用 Flask 和 Jinja2 模板编写的网络钓鱼框架，支持捕获 2FA 令牌 https://github.com/fireeye/PwnAuth OAuth 滥用测试检测平台 https://github.com/n0pe-sled/Postfix-Server-Setup 自动化建立一个网络钓鱼服务器 https://github.com/Dionach/PhEmail py2，钓鱼与邮件伪造 https://github.com/PHPMailer/PHPMailer 世界上最流行的 PHP 发送邮件的代码 http://tool.chacuo.net/mailanonymous 在线邮件伪造 http://ns4gov.000webhostapp.com 在线邮件伪造

中间人攻击流量劫持#

https://github.com/bettercap/bettercap 网络攻击以及监控的瑞士军刀。该工具支持多种模块，比如 ARP/DNS 欺骗、TCP 以及数据包代理等 https://github.com/mitmproxy/mitmproxy PY,支持 SSL 拦截，进行 https 流量代理 https://github.com/qiyeboy/BaseProxy py3,异步 http/https 代理,楼上简化版。可以作为中间人工具，比如说替换网址图片等 https://github.com/lgandx/Responder 用于嗅探网络内所有的 NTLM、NTLMv1/v2、Net-NTLMv1/v2 包，对网络内主机进行欺骗获取用户 hash。a 拿着 b 密码请求 b，c 对 a 说我是 b，然后 c 获得了 b 的密码，https://www.secpulse.com/archives/65503.html 【脉搏译文系列】渗透师指南之 Responder。 https://github.com/Kevin-Robertson/Inveigh 一款 PowerShell LLMNR / mDNS / NBNS 欺骗器和中间人工具 https://github.com/LionSec/xerosploit 中间人攻击测试工具包 https://github.com/AlsidOfficial/WSUSpendu 可以自主创建恶意更新，并将其注入到 WSUS 服务器数据库中，然后随意的分发这些恶意更新 https://github.com/infobyte/evilgrade 一个模块化的脚本框架，使攻击者在不知情的情况下将恶意更新注入到用户更新中 https://github.com/quickbreach/smbetray 专注于通过文件内容交换、lnk 交换来攻击客户端，以及窃取任何以明文形式传输的数据 https://github.com/mrexodia/haxxmap 对 IMAP 服务器进行中间人攻击

协议解析流量还原分析#

https://github.com/wireshark/wireshark 协议解析流量分析还原 https://github.com/CoreSecurity/impacket Impacket 是用于处理网络协议的 Python 工具包集合，内网中可用以提权例如 wmiexec.py、NMB，SMB1-3 和 MS-DCERPC 提供对协议实现本身的低级别编程访问。 https://github.com/secdev/scapy 内置了交互式网络数据包处理、数据包生成器、网络扫描器网络发现和包嗅探工具，提供多种协议包生成及解析插件，能够灵活的的生成协议数据包，并进行修改、解析。 https://gitee.com/qielige/openQPA 协议分析软件 QPA 的开源代码，特点是进程抓包、特征自动分析 https://github.com/jtpereyda/boofuzz 网络协议 fuzz 测试 https://www.jianshu.com/p/4dca12a35158 5 个常用的免费报文库 https://github.com/zerbea/hcxdumptool 从 Wlan 设备上捕获数据包 https://github.com/NytroRST/NetRipper 支持截获像 putty,winscp,mssql,chrome,firefox,outlook，https 中的明文密码 https://github.com/shramos/polymorph 支持几乎所有现有协议的实时网络数据包操作框架 https://github.com/nospaceships/raw-socket-sniffer C,PS，无需驱动抓取 Windows 流量

无线网络 WIFI 中间人攻击#

https://github.com/wi-fi-analyzer/fluxion 窃取用户 wifi 密码的进行密码重放攻击 https://github.com/0v3rl0w/e013 窃取 Wifi 密码. VB 脚本 https://github.com/cls1991/ng 获取你当前连接 wifi 的密码与 ip https://github.com/wifiphisher/wifiphisher PY,中间人攻击，FakeAp 恶意热点，WIFI 钓鱼，凭证窃取 https://github.com/1N3/PRISM-AP 自动部署 RogueAP(恶意热点) MITM 攻击框架 https://github.com/sensepost/mana Wifi 劫持工具，可以监听计算机或其他移动设备的 Wifi 通信，并能够模仿该设备 https://github.com/deltaxflux/fluxion bash 与 py，对使用 wpa 协议的无线网络进行 MiTM 攻击 https://github.com/DanMcInerney/LANs.py ARP 欺骗，无线网络劫持

无线网络 WIFI 防御#

https://github.com/SYWorks/waidps PY,Linux 下无线网络入侵检测工具 https://github.com/SkypLabs/probequest 嗅探和显示无线网卡附近的 Wifi Probe 请求 https://github.com/wangshub/hmpa-pi 在树莓派或路由，利用 Wireshark 扫描附近网络 WiFi 设备，当有手机或其它 Wi-Fi 设备在附近时，通过邮件或者微信提醒 https://github.com/besimaltnok/PiFinger 检查 wifi 是否为”Wifi-Pineapple 大菠萝”所开放的恶意热点 https://github.com/WiPi-Hunter/PiSavar 利用 PineAP，对于 FAKE AP 虚假接入点，如”Wifi-Pineapple 大菠萝”进行监测

无线网络 WIFI 审计测试#

https://www.wifislax.com 西班牙 wifi 审计系统，国内汉化版为无线革新 5.1.1 Wifislax-WRC https://cn.elcomsoft.com/ewsa.html ewsa，wifi 嗅探，握手包密码还原，EWSA-173-HC1UW-L3EGT-FFJ3O-SOQB3 https://www.passcape.com wifipr，握手包密码还原，另外还有许多商业版 windows 下密码还原工具 https://github.com/MisterBianco/BoopSuite 无线网络审计工具，支持 2-5GHZ 频段 https://github.com/aircrack-ng/aircrack-ng 由数据包嗅探器、检测器、WPA / WPA2-PSK 解密器、WEP 和用于 802.11 无线局域网的分析工具组成 https://github.com/t6x/reaver-wps-fork-t6x wps 跑 pin 码攻击，常见 wifi 攻击 https://github.com/derv82/wifite2 wifite 无线审计工具升级版，联动 aircrack-ng 与 reaver https://github.com/savio-code/fern-wifi-cracker 无线安全审计工具 https://github.com/P0cL4bs/WiFi-Pumpkin 无线安全渗透测试套件 https://github.com/entropy1337/infernal-twin 自动化无线攻击工具 Infernal-Wireless https://github.com/m4n3dw0lf/PytheM Python 网络/渗透测试工具 https://github.com/InfamousSYN/rogue 无线网络攻击工具包 https://github.com/cSploit/android 手机 WiFi 渗透工具框架，可以使用 msf https://github.com/chrisk44/Hijacker 手机 wifi 测试工具 https://andrax-pentest.org/ kali hunter 手机渗透测试系统 https://www.zimperium.com/zanti-mobile-penetration-testing 手机 wifi 渗透工具

数据取回隐秘传输#

https://github.com/TryCatchHCF/Cloakify 躲避 DLP/MLS 数据泄露防护系统，突破数据白名单控制，躲避 AV 检测进行数据盗取 https://github.com/sensepost/DET 使用单个或多个通道同时执行数据取回 https://github.com/Arno0x/DNSExfiltrator 利用 DNS 解析进行数据隐秘传输的工具 https://github.com/ytisf/PyExfil 用于数据取回的 Python 软件包 https://github.com/Arno0x/ReflectiveDnsExfiltrator 反射 DNS 解析隐蔽通道进行数据泄露

硬件安全#

https://github.com/unprovable/PentestHardware 硬件渗透测试实用手册 https://ducktoolkit.com/ 橡皮鸭、HID 键盘模拟器 https://github.com/insecurityofthings/jackit 用于 Mousejack 的开发代码 https://github.com/samyk/magspoof 信用卡信息盗取 https://github.com/mame82/P4wnP1_aloa 在树莓派 Raspberry Pi 上安装常用的测试组件，打造移动测试平台 https://www.freebuf.com/geek/195631.html 成为物理黑客吧！利用树莓派实现 P4wnP1 项目进行渗透测试 https://github.com/mame82/P4wnP1 在树莓派安装网络劫持键盘注入(WHID)工具 https://github.com/ebursztein/malusb 创建跨平台的 HID 欺骗 payload，并在 Windows 和 OSX 上建立反向 TCP-shell https://github.com/Orange-Cyberdefense/fenrir-ocd 主要功能和用途是绕过有线 802.1x 保护并使你能够访问目标网络 https://github.com/360PegasusTeam/GhostTunnel 可在隔离环境下使用 HID 生成隐蔽后门，释放有效负载后删除自身 https://github.com/LennyLeng/RadioEye RFID 配合常见的 NFC 使用 https://github.com/Proxmark/proxmark3/ RFID 神器 PM3 http://www.freebuf.com/news/others/605.html RFID Hacking–资源大合集 https://github.com/UnicornTeam/HackCube-Special 独角兽实验室硬件渗透测试平台

IoT 安全#

https://github.com/w3h/icsmaster 整合工控安全资源 https://github.com/V33RU/IoTSecurity101 IoT 工控安全与物联网安全学习的一些文章和资源 http://www.freebuf.com/ics-articles 工控相关 http://www.freebuf.com/sectool/174567.html 工业控制系统（ICS）安全专家必备的测试工具和安全资源 http://www.freebuf.com/articles/ics-articles/178822.html 浅析煤炭企业如何进行工控安全建设 http://www.freebuf.com/articles/network/178251.html 工控安全现场实施经验谈之工控系统如何加强主机防护 https://github.com/hslatman/awesome-industrial-control-system-security 工控系统安全方向优秀资源收集仓库 https://github.com/adi0x90/attifyos IoT 集成安全测试系统，带有一些常用的软件 https://github.com/moki-ics/moki 一键配置类似 kali 的工控渗透测试系统的脚本， https://gitlab.com/expliot_framework/expliot py3，工控安全漏洞测试框架 https://github.com/dark-lbp/isf py2,工控中类似 msf 的测试框架 https://github.com/enddo/smod py2，使用了 scapy 模块，主要针对 modbus 协议测试 https://github.com/shodan-labs/iotdb nmap 配合 shodan API 扫描 IoT 设备 https://github.com/XHermitOne/icscanner 带界面的 ics 扫描器 https://github.com/yanlinlin82/plcscan 通过 TCP/102 和 TCP/502 识别互联网上 PLC 设备和其他 Modbus 设备 https://github.com/nsacyber/GRASSMARLIN NSA 旗下 ICS/SCADA 态势感知 https://github.com/nezza/scada-stuff 对 SCADA/ICS 设备进行逆向与攻击

摄像头安全#

https://github.com/woj-ciech/kamerka 配合 shodan API 扫描到的摄像头地理位置显示在地图上 https://github.com/Ullaakut/cameradar GO,针对摄像头 RTSP 协议渗透测试，附弱口令字典 https://github.com/Ullaakut/camerattack GO,摄像头远程禁用 https://github.com/NIteshx2/UltimateSecurityCam py3，摄像头监测外来人员软件，有防欺骗设置

路由安全#

http://stascorp.com RouterScan 毛子开发的路由器漏洞利用工具，界面化很强大 https://github.com/threat9/routersploit py3，仿 msf 路由器漏洞利用框架 https://github.com/jh00nbr/Routerhunter-2.0 已停止更新，路由器漏洞扫描利用 https://github.com/googleinurl/RouterHunterBR php，路由器设备漏洞扫描利用 https://github.com/scu-igroup/telnet-scanner Telnet 服务密码撞库

物联网安全#

https://github.com/RUB-NDS/PRET 打印机攻击框架 https://github.com/rapid7/IoTSeeker 物联网设备默认密码扫描检测工具 https://github.com/schutzwerk/CANalyzat0r 专有汽车协议的安全分析工具包 https://github.com/pasta-auto 智能汽车测试

Fuzz 模糊测试漏洞挖掘#

http://www.freebuf.com/articles/rookie/169413.html 一系列用于 Fuzzing 学习的资源汇总 https://github.com/secfigo/Awesome-Fuzzing Fuzz 相关学习资料 https://github.com/fuzzdb-project/fuzzdb fuzz 资料数据库 https://github.com/ivanfratric/winafl AFL for fuzzing Windows binaries,原创技术分析 | AFL 漏洞挖掘技术漫谈 https://github.com/attekett/NodeFuzz a fuzzer harness for web browsers and browser like applications. https://github.com/google/oss-fuzz Continuous Fuzzing for Open Source Software http://blog.topsec.com.cn/ad_lab/alphafuzzer/ 以文件格式为主的漏洞挖掘工具 https://bbs.ichunqiu.com/thread-24898-1-1.html Test404 -HTTP Fuzzer V3.0 https://github.com/xmendez/wfuzz py，Web 安全模糊测试工具，模块化可处理 burp 所抓请求和响应报文 https://github.com/1N3/BlackWidow 基于 Python 实现的 Web 爬虫，用于收集目标网站的情报信息并对 OWASP 漏洞进行模糊测试 https://github.com/bunzen/pySSDeep py，一个基于模糊哈希（Fuzzy Hashing）算法的工具。go，glaslos/ssdeep；C，ssdeep-project/ssdeep https://github.com/googleprojectzero/winafl AFL 针对 Windows 二进制进行测试

安全防护#

https://github.com/baidu/AdvBox Advbox 是支持多种深度学习平台的 AI 模型安全工具箱，既支持白盒和黑盒算法生成对抗样本，衡量 AI 模型鲁棒性，也支持# 常见的防御算法 https://github.com/quoscient/octopus 区块链智能合约安全分析工具 https://github.com/Cyb3rWard0g/HELK 具有高级分析功能的威胁狩猎 ELK https://github.com/trimstray/otseca linux 系统审计工具，可以导出系统配置，生成报表 https://github.com/BugScanTeam/DNSLog 一款基于 django 监控 DNS 解析记录和 HTTP 访问记录的工具，可以配合盲注、xss、解析对方真实 ip 使用 https://github.com/mwrlabs/dref DNS 重绑定利用框架 https://github.com/chengr28/Pcap_DNSProxy/blob/master/README.zh-Hans.md Pcap_DNSProxy 是一个基于 WinPcap/LibPcap 用于过滤 DNS 投毒污染的工具 https://github.com/PlagueScanner/PlagueScanner 使用 python 实现的集成 ClamAV、ESET、Bitdefender 的反病毒引擎 https://github.com/m4rco-/dorothy2 一款木马、僵尸网络分析框架 http://github.com/jumpserver/jumpserver 基于 Python3 的开源堡垒机 https://github.com/github/glb-director 负载均衡组件 GLB，数据解析使用了 dpdk https://github.com/processhacker/processhacker 监控系统资源、软件调试、检测恶意软件，管理进程 https://github.com/TKCERT/mail-security-tester 检测邮件防护与过滤系统的测试框架 https://github.com/chaitin/sqlchop-http-proxy 利用 HTTP 反向代理，内置 SQLChop 作为 SQL 注入攻击检测模块，可以拦截 SQL 注入流量而放行正常流量 https://github.com/OWASP/SecureTea-Project 当有人私自触碰电脑鼠标或触摸板，进行报警

代码审计应用测试#

https://www.waitalone.cn/seay-source-code-auditv2.html Seay 源代码审计系统 2.1 版本 https://github.com/pyupio/safety 检查所有已安装 Python 包, 查找已知的安全漏洞 https://github.com/pumasecurity/puma-scan 实时代码审计，vs 插件 https://github.com/wufeifei/cobra 白盒代码安全审计系统 https://github.com/OneSourceCat/phpvulhunter 静态 php 代码审计 https://github.com/ripsscanner/rips 基于 php 的 php 代码审计工具 https://github.com/Qihoo360/phptrace 跟踪、分析 PHP 运行情况的工具 https://github.com/ajinabraham/NodeJsScan Node.JS 应用代码审计 https://github.com/ctxis/beemka 针对 Electron App 的漏洞利用工具包 https://github.com/doyensec/electronegativity Electron 应用代码审计，App 的错误配置和安全问题 https://github.com/shengqi158/pyvulhunter Python 应用审计 https://github.com/securego/gosec Go 语言源码安全分析工具 https://github.com/GoSSIP-SJTU/TripleDoggy 基于 clang 的 c/c++/object-c 源代码检测框架，有大量接口可以被调用 https://github.com/ga0/pyprotect 给 python 代码加密，防止逆向 https://github.com/presidentbeef/brakeman Ruby on Rails 应用静态代码分析 https://github.com/python-security/pyt 用于检测 Python Web 应用程序中的安全漏洞的静态分析工具 https://github.com/m4ll0k/WPSploit WordPress 插件代码安全审计 https://github.com/elcodigok/wphardening 加强任何 WordPress 安装的安全

大数据平台安全#

https://github.com/shouc/BDA 针对 hadoop/spark/mysql 等大数据平台的审计与检测 https://github.com/wavestone-cdt/hadoop-attack-library hadoop 测试方式和工具集

蜜罐安全#

https://github.com/paralax/awesome-honeypots 蜜罐开源技术收集 https://github.com/threatstream/mhn 现代蜜网，集成了多种蜜罐的安装脚本，可以快速部署、使用，也能够快速的从节点收集数据 https://github.com/dtag-dev-sec/tpotce T-POT，里面使用 docker 技术实现多个蜜罐组合，配合 ELK 进行研究与数据捕获 https://www.freebuf.com/sectool/190840.html T-Pot 多蜜罐平台使用心法 https://github.com/n3uz/t-pot-autoinstall 将 fork 的 T-POT 蜜罐的一键安装脚本替换为国内加速镜像

Web 蜜罐内网监测#

https://github.com/micheloosterhof/cowrie py2，使用 ELK（ElasticSearch，LogStash，Kibana）进行数据分析，目前支持 ssh，telnet，sftp 等协议 https://github.com/mushorg/snare py3，web 安全蜜罐，可克隆指定 Web 页面 https://github.com/honeynet/beeswarm py，使用 agent 探针与蜜罐进行实时交互来引诱攻击者 https://github.com/thinkst/opencanary PY2,SNMP\RDP\SAMBA 蜜罐 https://github.com/p1r06u3/opencanary_web PY,TORNADO,内网低交互蜜罐。支持自动化安装，目前支持常见的 16 中协议，现为探针/蜜罐-管理的架构，可以考虑二次开发为探针-沙盒-管理的架构 https://github.com/p1r06u3/opencanary_web https://github.com/Cymmetria 知名欺骗防御蜜罐组织。Struct、weblogic、telnet、Cisco ASA、Micros 等仿真蜜罐 https://github.com/Cymmetria/honeycomb Cymmetria 公司开源蜜罐框架，低交互 https://github.com/honeytrap/honeytrap 可扩展蜜罐框架，支持探针部署与高交互蜜罐 https://gosecure.net/2018/12/19/rdp-man-in-the-middle-smile-youre-on-camera/ RDP MITM，打造可记录图像和按键的 RDP 蜜罐（https://github.com/gosecure/pyrdp）

摄像头蜜罐#

https://github.com/alexbredo/honeypot-camera py，摄像头蜜罐。tornado 模拟 WEB 服务，图片代替视频，可以考虑后期多加点图片和按钮 https://github.com/EasyDarwin/EasyIPCamera C，RTSP 服务器组件用以构建摄像头蜜罐

工控蜜罐#

https://github.com/sjhilt/GasPot 模拟油电燃气工控系统 https://github.com/djformby/GRFICS IoT 工业仿真系统模拟框架，采用 MODBUS 协议对 PLC 虚拟机监视和控制 https://github.com/RabitW/IoTSecurityNAT IoT 测试系统，方便快速接入各种设备，进行安全测试 https://github.com/mushorg/conpot 针对 ICS/SCADA 的低交互工控蜜罐，模拟 Modbus 和 S7comm

逆向相关#

https://www.peerlyst.com/posts/resource-learning-how-to-reverse-malware-a-guide 恶意软件逆向指南和工具的集合 https://github.com/ReFirmLabs/binwalk 二进制 pwn 文件自动化逆向，拥有多种插件 https://github.com/angr/angr 一个具有动态符号执行和静态分析的二进制分析工具 https://github.com/endgameinc/xori 自定义反汇编框架 https://down.52pojie.cn/ 吾爱破解爱盘工具包 https://github.com/blacknbunny/peanalyzer32 PE 文件分析和反汇编工具 https://github.com/DominicBreuker/pspy 不用 root 权限就可以监控进程运行

CTF 相关#

https://ctf-wiki.github.io/ctf-wiki/ CTFwiki，Misc/Crypto/Web/Assembly/Executable/Reverse/Pwn/Android/ICS https://github.com/adon90/pentest_compilation ctf 比赛与 OSCP 考试中常见的知识点和命令 https://github.com/gabemarshall/microctfs 小型 ctf 镜像 docker https://github.com/giantbranch/pwn_deploy_chroot 部署多个 pwn 题到一个 docker 容器中 https://github.com/facebook/fbctf CTF 比赛框架 https://github.com/0Chencc/CTFCrackTools CTF 工具集成包 https://github.com/guyoung/CaptfEncoder CTF 密码编码全家桶，还有小程序版本 https://github.com/Gallopsled/pwntools pwn 类型，二进制利用框架 https://github.com/ChrisTheCoolHut/Zeratool pwn 类型，二进制利用框架 https://github.com/ChrisTheCoolHut/Rocket-Shot pwn，自动攻击脚本 https://0xrick.github.io/lists/stego/ 隐写术工具集，Steganography – A list of useful tools and resources https://github.com/DominicBreuker/stego-toolkit 隐写工具包 https://github.com/bugsafe/WeReport WeReport 报告助手 https://github.com/PELock/CrackMeZ3S-CTF-CrackMe-Tutorial 为 CTF 比赛编写 CrackMe 软件

计算机与移动设备取证调查#

https://www.freebuf.com/articles/rookie/195107.html 记一次微信数据库解密过程。微信的加密数据库的解密密码是由“设备的 IMEI(MEID)+用户的 uin，进行 MD5，然后取其前 7 位小写字母”构成的 https://www.audacityteam.org/ 音频文件和波形图处理工具 http://www.sweetscape.com/010editor/ 识别不同文件格式（模板）的 16 进制编辑器，具有文件修复功能 http://www.magicexif.com/ 将照片图像中的 exif 信息数据化 http://mediaarea.net/MediaInfo 类似 exiftool 来查看内容区域和元数据信息 https://www.sno.phy.queensu.ca/~phil/exiftool/ 检查图像文件的 exif 元数据 https://www.gimp.org/ Gimp 提供了转换各类图像文件可视化数据的功能，还可以用于确认文件是否是一个图像文件 https://github.com/volatilityfoundation/volatility windows 内存取证分析 https://github.com/gleeda/memtriage Windows 内存取证分析 https://github.com/SekoiaLab/Fastir_Collector Windows 取证/信息收集，不限于内存，注册表，文件信息等 https://github.com/Viralmaniar/Remote-Desktop-Caching– RDP 信息复原，png 图片格式 https://github.com/comaeio/LiveCloudKd C，针对 Hyper-V 的内存取证 –https://github.com/sevagas/swap_digger 针对 Linux swap 进行取证分析的工具 http://extundelete.sourceforge.net/ linux 下的文件恢复 https://github.com/viaforensics/android-forensics 安卓取证 App 和框架，可以对安卓设备内各种信息进行提取 https://github.com/davidmcgrew/joy 用来捕获和分析内外网流量数据的包，主要用于进行网络调查、安全监控和取证 https://github.com/USArmyResearchLab/Dshell 可扩展的网络取证分析框架，支持快速开发插件与解析网络数据包捕获 http://qpdf.sourceforge.net/ 查看 pdf 文件并整理提取信息 http://zipinfo.com/ 在无需提取的情况下列出了 zip 文件的内容信息 http://f00l.de/pcapfix/ pcap 文件修复 https://www.cgsecurity.org/wiki/TestDisk 磁盘分区修复 https://github.com/decalage2/oletools py，用于分析 MS OLE2 文件（结构化存储，复合文件二进制格式）和 MS Office 文档 https://www.xplico.org/download 内存取证 https://github.com/google/bochspwn-reloaded Bochspwn Reloaded（内核信息泄漏检测）工具 https://github.com/abrignoni/DFIR-SQL-Query-Repo 收集用于数据取证的 SQL 查询模板 https://www.freebuf.com/news/193684.html iOS 取证技巧：在无损的情况下完整导出 SQLite 数据库

移动安全#

https://github.com/Brucetg/App_Security App 安全学习资源 https://github.com/rovo89/Xposed 随心所欲修改安卓手机系统 https://github.com/android-hacker/VirtualXposed 基于 VirtualApp 和 epic 在非 ROOT 环境下运行 Xposed 模块的实现 https://github.com/MobSF/Mobile-Security-Framework-MobSF 移动安全审计框架。android、ios、win https://github.com/WooyunDota/DroidSSLUnpinning 安卓证书锁定解除的工具 https://github.com/nccgroup/house 运行时手机 App 分析工具包, 带 Web GUI https://github.com/UltimateHackers/Diggy 从 Apk 文件中提取 URLs 的工具 https://github.com/nettitude/scrounger iOS 和 Android 移动应用程序渗透测试框架 https://github.com/XekriCorp/LeakVM 安卓应用安全测试框架 https://github.com/zsdlove/ApkVulCheck 安卓漏洞扫描工具 https://github.com/samyk/frisky 针对 ios/macOS 应用的嗅探/修改/逆向/注入等工具 https://github.com/GeoSn0w/OsirisJailbreak12 IOS12 不完全越狱 https://github.com/chaitin/passionfruit iOS 应用逆向与分析工具，可以大大加速 iOS 应用安全分析过程

防火墙规则、Waf、CDN 相关#

https://github.com/baidu/openrasp RASP,Runtime Application Self-Protection，实时应用自我保护，更智能，针对每个语言定制 https://github.com/snort3/snort3 snort 算是最出名的开源 ids 入侵检测 https://github.com/chaitin/yanshi 长亭偃师（yanshi）,雷池（SafeLine）防火墙核心引擎使用到的代码生成工具 https://github.com/SpiderLabs/ModSecurity C，跨平台 WAF engine for Apache, IIS and Nginx https://github.com/klaubert/waf-fle ModSecurity Web 控制台 https://github.com/xsec-lab/x-waf 适用于中小企业的云 waf https://github.com/jx-sec/jxwaf 基于 openrestynginx+lua 开发，独创的业务逻辑防护引擎和机器学习引擎，解决传统 WAF 无法对业务安全进行防护的痛点 https://github.com/loveshell/ngx_lua_waf 基于 lua-nginx-moduleopenresty 的 web 应用防火墙 https://github.com/Janusec/janusec 基于 Golang 开发的应用安全网关，具备 WAF、CC 攻击防御、证书私钥加密、负载均衡、统一 Web 化管理等功能。 https://github.com/SpiderLabs/owasp-modsecurity-crs a set of generic attack detection rules for use with ModSecurity or compatible web application firewalls https://github.com/kirillwow/ids_bypass IDS Bypass 脚本 https://github.com/milo2012/ipv4bypass 利用 ipV6 地址绕过 waf https://github.com/3xp10it/bypass_waf 防火墙绕过脚本 https://github.com/m0rtem/CloudFail 针对 Cloudfail,查找位于 CDN 后面网站的真实 IP https://github.com/Nitr4x/whichCDN CDN 识别、检测 https://github.com/3xp10it/xcdn 尝试找出 cdn 背后的真实 ip，3xp10it.github.io 博客

入侵检测#

https://github.com/Neo23x0/Loki 一款 APT 入侵痕迹扫描器 https://github.com/ossec/ossec-hids 开源 hids 堡垒机 https://github.com/grayddq/HIDS hids 基于主机型入侵检测系统，一个人的安全部 https://github.com/ysrc/yulong-hids 驭龙 HIDS 是一款由 YSRC 开源的入侵检测系统 https://github.com/DianrongSecurity/AgentSmith-HIDS 点融开源 HIDS，开源部分为主机情报收集工具 https://github.com/Tencent/HaboMalHunter 哈勃分析系统，linux 系统病毒分析及安全测试 https://github.com/JPCERTCC/LogonTracer 根据 win 登陆记录日志来分析并用图形化展示恶意登陆行为 https://github.com/anwi-wips/anwi 无线 IDS, 基于低成本的 Wi-Fi 模块(ESP8266) https://github.com/Security-Onion-Solutions/security-onion 基于 ubuntu 用于入侵检测，网络安全监控和日志管理，采用分布式架构 https://github.com/jpcertcc/sysmonsearch 将 Sysmon 的日志结果可视化 http://m.imooc.com/article/21236 快速自检电脑是否被黑客入侵过(Windows 版) http://www.freebuf.com/articles/system/157597.html 快速自检电脑是否被黑客入侵过（Linux 版） http://www.freebuf.com/rookie/179638.html 服务器入侵溯源小技巧整理 https://github.com/zhanghaoyil/Hawk-I 基于无监督机器学习算法从 Web 日志中自动提取攻击 Payload

恶意文件测与样本分析#

https://github.com/open-power-workgroup/Hospital 全国莆田系医院名单 https://github.com/chenerlich/FCL 恶意代码使用的命令行收集 https://paper.seebug.org/421 常见软件合集与恶意软件分析 https://github.com/sapphirex00/Threat-Hunting apt 恶意软件样本 https://www.malware-traffic-analysis.net/ 恶意软件样本 http://dasmalwerk.eu/ 恶意软件样本 https://github.com/ytisf/theZoo 恶意软件样本 https://github.com/mstfknn/malware-sample-library 恶意软件样本 http://99.248.235.4/Library/ 恶意软件样本库。ladder https://github.com/robbyFux/Ragpicker 恶意软件信息爬取汇总分析 https://github.com/phage-nz/ph0neutria 恶意软件信息爬取汇总分析 https://github.com/JR0driguezB/malware_configs 常见恶意配置文件 https://github.com/sfaci/masc 扫描网站中的恶意软件, 以及其他一些网站维护功能 https://github.com/Neo23x0/munin 依据文件 Hash 从各种在线恶意软件扫描服务提取信息的工具 https://github.com/1lastBr3ath/drmine 自动化检测网页是否包含挖矿脚本的工具 https://github.com/KasperskyLab/klara 卡巴斯基开源基于 Yara 的分布式恶意软件扫描系统, https://github.com/botherder/kraken go，实现的 Yara 恶意软件扫描器 https://github.com/alexandreborges/malwoverview simple，将恶意文件进行快速分类 https://github.com/joxeankoret/pigaios 直接对比源代码与编译的二进制文件 https://github.com/viper-framework py2，二进制分析和管理框架，对恶意文件进行分析 https://github.com/netxfly/sec_check 通过信息采集（账户、连接、端口等）与 yara 扫描进行安全检测 https://github.com/nao-sec/tknk_scanner yara 引擎为基础的恶意软件识别框架 https://github.com/felixweyne/ProcessSpawnControl powershell,对恶意程序进行检测与监控 https://github.com/Aurore54F/JaSt 使用语法检测恶意/混淆的 JS 文件，https://www.blackhoodie.re/assets/archive/JaSt_blackhoodie.pdf http://edr.sangfor.com.cn/ win，Linux 下恶意软件、webshell 检测查杀工具 http://www.clamav.net/downloads 病毒查杀软件 http://www.chkrootkit.org/ rootkit 检测工具 http://rootkit.nl/projects/rootkit_hunter.html rootkit 检测工具

恶意文件检测之 Webshell 查杀扫描#

http://www.safedog.cn/ 安全狗 web 防火墙 http://d99net.net/ win，啊 D 出品 D 盾 _ 防火墙，包含 waf 与 webshel 检测功能 https://github.com/he1m4n6a/findWebshell py，webshell 检查工具，可后期添加后门指纹，很强大 https://github.com/ym2011/ScanBackdoor 一款简洁的 Webshell 扫描工具 https://github.com/erevus-cn/scan_webshell webshell 扫描工具 https://github.com/yassineaddi/BackdoorMan 可对指定目录进行 php webshell 检测 https://github.com/nbs-system/php-malware-finder 一款高效率 PHP-webshell 扫描工具 https://github.com/emposha/PHP-Shell-Detector 测试效率高达 99%的 webshell 检测工具 https://github.com/emposha/Shell-Detector Webshell 扫描工具，支持 php/perl/asp/aspx webshell 扫描

压力测试与 DDOS 相关#

https://github.com/ywjt/Dshield DDOS 防护 https://github.com/NewEraCracker/LOIC/ 一个为 Windows 设计的网络压力测试工具现已支持 Mac OS——译者注 https://github.com/649/Memcrashed-DDoS-Exploit 利用 Memcached 服务器的 DDoS 攻击工具, 向 Memcached 服务器发送伪造的 UDP 数据包使其向攻击目标回复大量数据包 https://github.com/jseidl/GoldenEye py，DOS 测试 https://github.com/mschwager/dhcpwn DHCP IP 资源耗尽攻击工具 https://github.com/Microsoft/Ethr GO,跨平台,TCP, UDP, HTTP, HTTPS 压力测试工具

匿名信息保护洋葱路由 TorBrowser#

https://github.com/leitbogioro/Fuck_Aliyun 关闭阿里云监控服务 https://github.com/Nummer/Destroy-Windows-10-Spying DWS 关闭 windows 监控服务 https://github.com/Rizer0/Log-killer 日志清除，Windows/Linux 服务器中的所有 https://github.com/360-A-Team/EventCleaner 日志擦除工具 https://github.com/s-rah/onionscan darkweb 暗网爬虫 https://github.com/globaleaks/Tor2web darkweb 暗网代理服务器，将 onion 的服务变为普通的服务 https://github.com/milesrichardson/docker-onion-nmap 使用 nmap 扫描 Tor 网络上隐藏的”onion”服务 https://github.com/GouveaHeitor/nipe 一个使所有流量通过 Tor 网络发出的脚本 https://github.com/trimstray/multitor 启用多个 tor 通道转发流量，并设置负载均衡

爬虫相关#

https://github.com/alphardex/looter 轻量型爬虫框架，类比 Scrapy https://github.com/luyishisi/Anti-Anti-Spider 过反爬虫 https://github.com/xchaoinfo/fuck-login 模拟登录一些常见的网站 https://github.com/Maicius/InterestingCrawler 抓取 QQ 空间说说内容并进行分析 https://github.com/xjr7670/QQzone_crawler QQ 空间动态爬虫，利用 cookie 登录获取所有可访问好友空间的动态保存到本地

在线自服务与工具#

https://github.com/Kickball/awesome-selfhosted awesome 系列之自服务应用 https://github.com/littlecodersh/itchat 微信个人号接口、微信机器人及命令行微信 https://github.com/sym233/core-values-encoder js,社会主义核心价值观加密，https://sym233.github.io/core-values-encoder/ https://github.com/valentinxxx/nginxconfig.io/ 在线 nginx 配置文件生成，demo 网址 https://nginxconfig.io https://github.com/asciimoo/searx 搭建一个自己的搜索引擎,DEMO 网址 https://searx.me/ http://sc.ftqq.com/3.version server 酱微信通知 https://osint.link Open Source Intelligence (OSINT) Tools & Resources https://www.wolframalpha.com 根据问题直接给出答案的网站 shodan.io 互联网感知引擎 fofa.so 白帽汇 NOSEC https://www.oshadan.com 傻蛋联网设备搜索 _ 湖南安数网络 zoomeye.org 知道创宇互联网感知引擎 https://sms.cngrok.com/receiving-sms 收码接码 https://www.pdflibr.com/ 收码接码 https://www.fakenamegenerator.com 多国身份信息模拟器 https://recruitin.net Easily use Google to search profiles on LinkedIn https://www.truthfinder.com 美国公民信息查询 https://verify-email.org 邮件真实性验证 https://safeweb.norton.com 诺顿网站安全检测 http://www.vuln.cn/tools/ftp 在线 FTP 登录 http://www.link114.cn/title/ 批量查询网站标题 https://www.whatweb.net/ 在线 web 指纹识别 https://hackertarget.com/ip-tools/ 提供 api，ip 相关工具、在线扫描器 http://www.webscan.cc/ 同 IP 网站查询,C 段查询,IP 反查域名,C 段旁注,旁注工具 https://www.phpinfo.me/bing.php 在线旁站查询|C 段查询|必应接口 C 段查询 https://www.phpinfo.me/domain/ 在线子域名爆破 https://www.dnsdb.io DNS 查询,子域名查询,IP 查询,A 记录查询,域名解析,旁站查询 https://dnsdumpster.com/ dns recon and research, find and lookup dns records http://ip.chaxun.la/ ip 反查域名—查询啦 https://habo.qq.com 在线恶意文件检测 https://www.virustotal.com 恶意软件检测 http://r.virscan.org/ 恶意软件检测 https://www.appscan.io 移动软件在线检测 https://www.nomoreransom.org 常见勒索软件分析还原 https://www.cmd5.com/ HASH 密码在线破解 https://www.onlinehashcrack.com 密码哈希在线破解，邮件通知

在线办公套件#

https://sadd.io/ 在线操作系统 https://github.com/zyx0814/dzzoffice 在线办公套件,DEMO 网址 demo.dzzoffice.com https://github.com/RobbieHan/gistandard py，基于 Django，OA 工单办公管理系统 https://github.com/pavanw3b/sh00t PY3,DJANGO，安全测试工单管理 https://github.com/chaitin/strapdown-zeta 基于 strapdown.js，长亭二次开发开源的 Wiki 系统，支持 markdown https://etherpad.net/ 在线可编辑记事本 https://www.upload.ee/ 文件共享平台 https://github.com/micahflee/onionshare 利用 onion 洋葱服务器匿名文件共享 https://github.com/filebrowser/filebrowser GO,基于 Caddy 框架的网盘 https://github.com/nextcloud/server php，私有云网盘，owncloud 分支 https://github.com/owncloud/core php，私有云网盘，界面不美观 https://github.com/haiwen/seafile C,私有云网盘，速度快，功能少 https://github.com/ymfe/yapi API 管理工具 https://thyrsi.com/ 图片上传分享工具

隐私匿名加密#

https://www.lshack.cn/118/ 在线接收验证码/邮箱/粘贴板/文件传输大集合。 http://bccto.me 一次性邮箱 https://www.guerrillamail.com 一次性邮箱 http://24mail.chacuo.net/ 一次性邮箱 http://www.yopmail.com 一次性邮箱 https://yandex.com/ 非手机邮箱 https://mail.ru/ 非手机邮箱 https://mail.protonmail.com/login 非手机邮箱 https://github.com/walkor/workerman-chat php，在线聊天室，可扩展 https://github.com/hack-chat https://hack.chat/?your-channel js,在线聊天，问号后面跟你的房间名 https://github.com/akaxincom/openzaly java,聊天室，Akaxin 为客户端闭源 https://github.com/RocketChat/Rocket.Chat js,在线团队聊天服务器，https://rocket.chat/install https://telegram.org https://www.whatsapp.com https://wire.com/en https://signal.org http://www.batmessenger.com http://sid.co

在线资源#

https://github.com/DoubleLabyrinth/navicat-keygen navicat 注册机 https://github.com/DoubleLabyrinth/MobaXterm-keygen MobaXterm 注册机 http://www.zdfans.com zd423 – 软件分享平台领跑者 https://www.flaticon.com 免费图标网站 https://msdn.itellyou.cn 原生镜像 https://www.freenom.com 注册免费域名，dns 解析 https://codebeautify.org 在线代码美化 http://patorjk.com Text to ASCII Art Generator https://www.seopojie.com SPAM,SEO ———————————————— 版权声明：本文为CSDN博主「CKCsec」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。原文链接：https://blog.csdn.net/qq_46717339/article/details/122366277

Ernest的Blog

使用Github Actions 完成编译、发布release apk

创建签名环境#

创建存储签名文件的私有仓库#

添加签名文件仓库为git的子模块#

加密的环境变量 Secrets#

修改app签名配置#

配置Github Actions#

Github Actions 触发条件#

Github Actions 的子模块配置#

读取Actions 加密系统环境变量#

上传apk文件到github release#

curl批量下载并设置正确名称

Android处理dicom文件记录

dcm4che#

Modules#

Utilities#

imebra#

PixelMed#

DCMTK#

一句话笔记：常用linux命令

文件系统远程挂载#

开机自动挂载文件#

curl,apt 设置代理#

批量替换文件内容#

软连接#

配置 ipv6#

重启网卡#

一句话笔记：常用mac命令

双网卡路由配置#

文件系统远程挂载#

开机自动挂载文件#

curl,apt 设置代理#

批量替换文件内容#

一句话PT笔记

盒子（seedbox）限制汇总，H&R汇总#

Android基于Modbus RTU协议通过蓝牙与蓝牙串口开发板通信

Android基于Modbus RTU协议通过蓝牙与蓝牙串口开发板通信#

前言#

实现原理#

在Android上实现Modbus RTU Master#

组装Modbus RTU消息帧#

ModbusErrorType#

ModbusError#

ModbusFunction#

ByteArrayWriter#

ByteUtil#

CRC16#

ModbusRtuMaster完整代码#

在Android上实现用蓝牙传递Modbus Rtu协议帧#

字节数组转换为 16 进制字符串的方法#

最终效果#

ADB 操作命令详解及用法大全

一、ADB是什么？#

二、ADB有什么作用？#

三、ADB命令语法#

单一设备/模拟器连接#

多个设备/模拟器连接#

四、ADB常用命令#

4.1 基本命令#

4.1.1 查看adb的版本信息#

4.1.2 启动adb#

4.1.3 停止adb#

4.1.4 以 root 权限运行 adbd#

4.1.5 指定 adb server 的网络端口#

4.1.6 查询已连接的设备/模拟器列表#

4.2 设备连接管理#

4.2.1 USB 连接#

4.2.2 WLAN 连接（需要 USB 线）#

4.2.3 WLAN 连接（无需借助 USB 线）#

4.2.4 WiFi 连接转为 USB 连接#

4.3 应用管理#

4.3.1 查看应用列表#

4.3.1.1 查看所有应用#

4.3.1.2 查看系统应用#

4.3.1.3 查看第三方应用#

4.3.1.4 包名包含某字符串的应用#

4.3.2 安装应用#

4.3.3 卸载应用#

4.3.4 清除应用数据与缓存#

PixelMed #